crates.io: docs.rs link is missing from search results
For crates without a documentation key in their Cargo.toml, crates.io is supposed to generate a Documentation link to docs.rs. However, this Documentation link is sometimes missing on search results.
Steps to reproduce:
- Open a fresh browser instance. (For example, I’m using
chromium --user-data-dir="$(mktemp -d)"on Arch Linux.) - Navigate to https://crates.io/search?q=ndarray-npy
- Observe that there is no
Documentationlink for thendarray-npycrate. (It should be there, but it is missing. That’s what this issue is about.) - Click on the
ndarray-npycrate link (URL: https://crates.io/crates/ndarray-npy). - Click the “back” button on your browser to navigate back to the previous page.
- Observe that the
Documentationlink has now appeared.
I’m observing this behavior for crates that do not include a documentation key in their Cargo.toml. Currently, examples of this include the ndarray-npy, py_literal, aho-corasick, unreachable, and void crates, among many others.
About this issue
- Original URL
- State: open
- Created 8 years ago
- Reactions: 4
- Comments: 21 (17 by maintainers)
Commits related to this issue
- Improve crate metadata used on crates.io * Updates crate descriptions now that we have several crates. * Adjusts `repository` for the ancillary crates to deep link to their directory in the monorep... — committed to heroku/libcnb.rs by edmorley 5 years ago
- Improve crate metadata used on crates.io (#325) * Updates crate descriptions now that we have several crates. * Adjusts `repository` for the ancillary crates to deep link to their directory in th... — committed to heroku/libcnb.rs by edmorley 5 years ago
- Auto merge of #14561 - RalfJung:crates-io-docs, r=weihanglo remove reference to incomplete crates.io feature from docs The cargo docs for the `documentation` field currently are written in a way tha... — committed to rust-lang/cargo by bors 2 years ago
- frontend: change logic of when doc links are shown in search results The crate version page uses a fallback to handle crates that don't define `documentation` keys in their manifests: if docs.rs has ... — committed to LawnGnome/crates.io by LawnGnome 2 years ago
I think it should link to the version number that is shown in the search results. Then if that version is still building docs.rs can show a message saying “this is still in the queue” and offer a link to an earlier version that has already been built.