Readme improvements

[camsteffen]

Moved the table of contents up, added an Overview heading.

Made the "All the Clippy Lints" link clearer.

Formatted the lint categories as a table with the default lint level (instead of saying on/off by default). Tweaked the descriptions.

changelog: Improve Readme

[rust-highfive]

r? @llogiq

(rust_highfive has picked a reviewer for you, use r? to override)

[flip1995]

I don't see how this makes the "All the Clippy lints" link clearer. Having the ToC where it currently is, is actually intentional, since we want to have the most relevant information for the user at the top. If you want more information, you scroll past this either way. Having a ToC on top doesn't help find this information faster.

-1 for this change from me.

I like the reformat to a table though (but without the traffic lights). clippy::all is warn/deny

[llogiq]

As @flip1995 wrote, we would want some changes before merging this.

I will look into this later, just know that we'll need some discussion.

[camsteffen]

Here is take 2 with flip1995's input: camsteffen@25be6e7

[flip1995]

The changes in camsteffen@25be6e7 LGTM. @llogiq r=me if those changes are pushed and you're also good with them. 👍

[llogiq]

The problem becomes that cargo dev update_lints expects a number of certain sequences of text in the README, which have now changed. Look at clippy_dev/src/update_lints.rs.

[camsteffen]

Pushed the revised version. I think that resolves the concern with cargo dev update_lints. The main thing is adding default lint levels so I don't mind tossing the other changes.

[llogiq]

Thank you! @bors r+

[bors]

📌 Commit fd8dece has been approved by llogiq

[bors]

⌛ Testing commit fd8dece with merge 4aca13f...

[bors]

☀️ Test successful - checks-action_dev_test, checks-action_remark_test, checks-action_test
Approved by: llogiq
Pushing 4aca13f to master...