Right now we have two kinds of prose headings in Rustdoc. Those generated from author-written Markdown:
And those generated by Rustdoc itself:
The former are hyperlinks (to themselves), and so get a blue color. The latter are not hyperlinks, and so are black.
We should make the Rustdoc-generated prose headings also be hyperlinks to themselves, since the heading provides a larger click target than the §. We should also decide whether we want headings to be blue or black (I have a slight preference for black). Thoughts @rust-lang/rustdoc?
One other possibility would be that we want to preserve the color distinction between author-generated headings and Rustdoc-generated headings. However, as pointed out in #59829, the more things we use colors to distinguish, the harder it is to get people's attention on distinctions that really matter.
Right now we have two kinds of prose headings in Rustdoc. Those generated from author-written Markdown:
And those generated by Rustdoc itself:
The former are hyperlinks (to themselves), and so get a blue color. The latter are not hyperlinks, and so are black.
We should make the Rustdoc-generated prose headings also be hyperlinks to themselves, since the heading provides a larger click target than the §. We should also decide whether we want headings to be blue or black (I have a slight preference for black). Thoughts @rust-lang/rustdoc?
One other possibility would be that we want to preserve the color distinction between author-generated headings and Rustdoc-generated headings. However, as pointed out in #59829, the more things we use colors to distinguish, the harder it is to get people's attention on distinctions that really matter.