Skip to content

Source code link looks like a documentation link, causing user confusion #12721

@epage

Description

@epage

Current Behavior

Image

I saw the green "docs" and immediately went to click it, it standing out more than the slightly larger but black headers

Image

I was then confused how I ended up on this page. My first thought was the documentation build was broken. It took me a while to notice the "Documentation" link on the right because that was the opposite of where my eyes were searching for any relevant links to figure out what to do. The recent source code link addition didn't even cross my mind as to how I got there. Even if it had, that still was a road hump in my path to a successful interaction.

Expected Behavior

The main criteria is making the two docs.rs links stand out from each other.

One idea is that instead of header / link, maybe make the headers the link text like on the search results. If people want to know where it goes, they can always hover and have their browser show them.

More ideally, work to integrate crates.io and docs.rs (which I brought up on Internals) so the source code view is just another tab or something.

Steps To Reproduce

  1. Go to crates.io
  2. Search for a crate (especially if it doesn't have package.documentation set so documentation doesn't show up in the search list)
  3. Click on the crate
  4. Quickly, without really looking, click on the documentation link

Environment

  • Browser: Firefox
  • OS: PopOs 24.04

Anything else?

When this was first released, I was confused at the double docs.rs and then noticed the headers.

Today I was trying to get to documentation (didn't remember the exact package name so I started with crates.io) and had this experience.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions