Improve lint doc consistency

[Serial-ATA]

changelog: none

This is a continuation of #8908.

Notable changes:

• Removed empty Known Problems sections
• Removed "Good"/"Bad" language (replaced with "Use instead")
• Removed (and added some 😄) duplication
• Ignored the [create_dir] example so it doesn't create clippy_lints/foo 😄

[rust-highfive]

r? @xFrednet

(rust-highfive has picked a reviewer for you, use r? to override)

[xFrednet]

I'm done with the first batch ~33 files or so. 🙃 Thank you for taking the time, this looks like you've actually read every description, which is impressive!

[xFrednet]

Looks good overall, a few small comments. Everything should be simple to fix and then ready to be merged.

I hope I wasn't too nit-picky

[xFrednet]

This is another weird let statements. I'll point them out, since I've understood you, that these should be reverted again, as they're not ideal. I'll copy and passta 🍝 this comment, so if you disagree, feel free to only state that once or on the specific case 🙃

[Serial-ATA]

For these ones, I thought it looked better to just show the literals themselves. Since it applies in all contexts I didn't think the let statement was all that important for the reader to see.

[xFrednet]

Alright, I'm a bit torn, since I think it looks weird in the code, but the main focus should be the lint list documentation, where this will show correctly.

[xFrednet]

Alright, this version looks good to me. Thank you for the help and quick answers.

@bors r+

[bors]

📌 Commit 649ac36 has been approved by xFrednet

[bors]

⌛ Testing commit 649ac36 with merge 4970527...

[bors]

☀️ Test successful - checks-action_dev_test, checks-action_remark_test, checks-action_test
Approved by: xFrednet
Pushing 4970527 to master...

[Serial-ATA]

@xFrednet thanks for getting the review done so quickly, really appreciate it! ❤️