[website]: Add structured metadata to rules, e.g. to indicate which version a rule was introduced in

[corneliusroemer]

Turning this comment into a separate issue:

On a similar note I have multiple times tried to figure out in which specific version of ruff that a rule was introduced or modified (bugfix, "upgraded" from nursery/preview to stable rule).

Having versioned documentation or some version information in each rule's docpage would make this much easier than today.

Originally posted by @kaddkaka in #9507

I concur this would be nice. Rust's Clippy does this really well:

https://rust-lang.github.io/rust-clippy/stable/index.html

I would also appreciate (structured) metadata being shown in docs, such as version a rule was introduced in.

[kaddkaka]

Wezterm documentation is another great example which keeps each version specific documentation in the latest documentation, see for example https://wezterm.org/config/lua/config/window_decorations.html

[corneliusroemer]

Wezterm documentation is another great example which keeps each version specific documentation in the latest documentation, see for example https://wezterm.org/config/lua/config/window_decorations.html

Adding a screenshot to save (most) readers a link click:

Note there are 2 types of version information here:

• when the rule was first introduced/added
• in addition, if new options became available after the initial introduction, they are inside a separate box

To my taste, this is a little hard to parse for first time visitors - though the repeat visitor might appreciate the granular information. Looks fairly tricky to maintain those versioned boxes though for changes.