Skip to content

Please put docs and repo links back to the top of the page #3377

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
ijackson opened this issue Mar 8, 2021 · 1 comment
Closed

Please put docs and repo links back to the top of the page #3377

ijackson opened this issue Mar 8, 2021 · 1 comment

Comments

@ijackson
Copy link

ijackson commented Mar 8, 2021

Describe the bug

The links to a project's documentation and repository are much harder to find quickly than they used to be.

To Reproduce

Steps to reproduce the behavior:

  1. Go to https://crates.io
  2. enter "serde" in the search box, and click through to https://crates.io/crates/serde to read the README
  3. Decide to read the docs or visit the repo to look at issues/MRs/etc.
  4. Try to find the docs link on the page.
  5. Scan through the stuff in the right sidebar and eventually find it.

Expected behavior

The links to documentation and repository shoudl be as prominent as they were before the recent update, and as prominent as they are on the search results page.

They should be at least as prominent as the new keywords links. They should be in a fixed location on the page, near the top (so they should not ever require scrolling or visual scanning of the page).

Ideally they would be restored to a location similar to their previous location, before the last redesign, so as to provide continuity for existing users.

IMO such a high prominence and consistency of location is necessary because these links are not simply metadata or information about the package. They are key elements of the navigation structure between crates.io, docs.rs, repositories, and general search engines.

Additional context

I appreciate that filing this as a bug rather than a feature request or something might be seen as overly insistent.

However it seems to me that it would be difficult to argue that the documentation and repo links are less important than the last update, the crate source code size, or the "Install" fragment with c&p for Cargo.toml. Rather, the fact that the docs and repo links are on the search page suggests that it is recognised that these are critically important navigation. Having these two links then buried so badly on the next page is poor UI design.

On a personal and more subjective note I find this change major useability regression, and it seems there are others who agree.

I think calling this a bug is justified by the combination of (as I see it) a problem which (i) can to a large extent be characterised objectively (ii) is a significant regression (at least for a number of people) compared to previous behaviour.

I found #3352. Some of the comments there provide additional context and motivation for my request.

I am filing this as a separate report because I thought it would be helpful to set out explicitly a report which contains only a request for llimited, specific, and immediately actionable changes.

I'm hoping that we can keep #3352 for general discussion of the new layout and principles for managing the crates.io web UI, and keep this issue for specifically the location of the docs and repo links.

@ijackson ijackson added the C-bug 🐞 Category: unintended, undesired behavior label Mar 8, 2021
@Turbo87 Turbo87 added A-frontend 🐹 and removed C-bug 🐞 Category: unintended, undesired behavior labels Mar 8, 2021
@Turbo87
Copy link
Member

Turbo87 commented Dec 23, 2021

FWIW several people have also expressed that they very much like these changes, and there are quite a few other package registries that do similar things. in other words: I find it quite a strong statement to claim that this is objectively a major useability regression.

as you can see at this point, we haven't just moved the links, but we've also made it easier to see where those links link to, so that you don't have to click blindly or hover over the link to see where it goes. this simply wouldn't have been possible by keeping them horizontally next to each other in the header bar.

The links to a project's documentation and repository are much harder to find quickly than they used to be.

I think this is primarily caused by those links being in their old positions for such a long time, and adjusting to UI changes can be hard if you've become used to seeing things in the same place all the time. I'm confident though that you are able rewire your brain to look for the links in their new positions.

@Turbo87 Turbo87 closed this as completed Dec 23, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants