Simplify and unify rustdoc sidebar styles #59860
Labels
A-rustdoc-ui
Area: Rustdoc UI (generated HTML)
T-rustdoc
Relevant to the rustdoc team, which will review and decide on the PR/issue.
Rustdoc's sidebar uses several visually heavyweight elements, and also has inconsistent styling between different sections.
This has been broken out of #59829 to provide smaller, actionable items that can be independently discussed and worked on. A review of rustdoc for accessibility, especially for dyslexia and attention disorders, finds that there are a number of visually distracting elements in rustdoc which can draw attention away from the main content. This should be considered along with the other issues mentioned in #59829 about the overall effect of a number of distracting elements on the page.
There are several heavyweight UI elements.
In addition, the two sections have quite inconsistent styling.
We can compare that with the sidebar in mdBook; while they serve different purposes, it is useful to look at them together.
mdBook simply uses an outline view for nesting, without larger or bolder headings. It does have bold chapter/section numbers, which is slightly attention grabbing, but otherwise is both a simpler style and fits more content into the sidebar with less decoration.
Specific recommendations:
The text was updated successfully, but these errors were encountered: