Skip to content

rustdoc: Generated themes hide/make navigation links not-obvious #94089

Open
@vexx32

Description

@vexx32

Currently some of the navigation links in rustdoc are being colored the same color as surrounding text, which is super bad for actually being visually navigable. This is the only link I can find to navigate to the parent module from the docs page for the struct. It should not be this hard to notice.

Easiest example is basically any page on docs.rs, one example: https://doc.rust-lang.org/std/collections/struct.HashMap.html

image

This screenshot was taken with the Ayu theme, but the same problem is present in every available theme currently. Hovering collections here highlights it as a link with an underline, but that is very not-obvious at a glance (the underline is only present on hover), so it's not at all clear how to navigate from (for example) a struct to its parent module page, in many cases.

Any navigable link should be visually distinct from the surrounding text. Currently, these kinds of links are not. See also https://usability.yale.edu/web-accessibility/articles/links#designing-links

Arguably, all links should be reasonably similar so that users aren't conditioned to expect links to be one thing or a small subset of things, and then there are other links styled completely differently hidden in other areas of the page. Especially having a link that looks like plaintext right alongside a link that is visually obvious is misleading.

N.B.: Apologies for probably picking the wrong template; I couldn't find a template that seemed to be suited for the generated UI/theming or anything specific to Rustdoc.

Metadata

Metadata

Assignees

No one assigned

    Labels

    A-rustdoc-themesArea: Themes for HTML pages generated by rustdocA-rustdoc-uiArea: Rustdoc UI (generated HTML)C-bugCategory: This is a bug.T-rustdocRelevant to the rustdoc team, which will review and decide on the PR/issue.

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions