docs(website): include rule path in rule pages

[Vivalldi]

Summary

Motivation: this helps know which group the rule belongs. Otherwise readers have to rely on the generated valid/invalid outputs to know the full rule name.

Open to feedback on how this should look

Test Plan

• Look at generated lint rule pages

[ematipico]

This change is very appreciated, I was looking to do something similar.

I suggest a few changes, let me know what you think:

• I would call it "diagnostic category". That's really what it is. Maybe it can be misleading because we use it in suppression comments too;
• rules pages are all auto-generated from source code, you'll need to change xtasks/lintdoc/src/lib.rs

[Vivalldi]

• I would call it "diagnostic category". That's really what it is. Maybe it can be misleading because we use it in suppression comments too;

Love it! Any formatting suggestions? Things I've considered

• Just using bold (current)
• Headers (all seemed a bit too big)
• A subtitle below main title (thought this would be ideal but found wasn't as easy to add to template as thought)

• rules pages are all auto-generated from source code, you'll need to change xtasks/lintdoc/src/lib.rs

Would this be in addition to the changes made in xtask/lintdoc/src/main.rs? Or should I only make the change in lib.rs? I don't see a xtasks/lintdoc/src/lib.rs, only main.rs

[ematipico]

Yeah sorry, it's main.rs. Didn't remember 🥲

I like the current proposal!