Summary

This PR marks the top-level lint settings as deprecated (schema only) and updates the website to document the options under the lint section (removes the top-level settings).

I had to make changes to the documentation generation to now support 3-level deep options

• The documentation now shows the entire name for sub-sub-sections (e.g. lint.pydocstyle instead of pydocstyle) because sub-sub-sections are rendered at the same level as sub-sections.
• The anchor link now contains the entire parent chain: lint.pycodestyle.xxx instead of pycodestyle.xxx.
• The anchor link now use _ instead of - as a separator to disambiguate between the subsection lint.pydocstyle and option lint-pydocstyle

I feel undecided about one open question: Should we use the full setting name in READMEs or only the name? For example. Should we write lint.ignore or ignore? Or a more extreme example. Should we write max-complexityorlint.mccabe.max-complexity`. We currently use a mix of both:

• The tutorial mainly uses the short names
• Rules use the full name (until today without the lint prefix)

I changed the tutorial to use long names in most positions but it didn't always feel right.

Considerations

One downside of removing the top-level settings from the website is that Ruff's documentation isn't versioned. Users using an older version of ruff that only supports the global settings or use the global options might be confused why the options are missing.

A possible solution is adding aliasing support to our documentation generation, although that might be tricky.

IMO, removing is fine because the lint section has been supported since v0.0.292, which feels like a very long time ago.

Next steps

Emit deprecation messages when a configuration uses any deprecated top-level settings.

Test Plan

• I built the documentation locally and verified that the lint options are only listed once under the lint section (which helps discoverability).
• I read through the documentation and clicked through the setting options to verify that the anchor links work
• I reviewed the schema changes and it marks the top level lint settings as deprecated.

Danger: Only merge before the 0.2.0 release