rust-lang / rust-lang/docs.rs

"The requested version does not exist" for yanked crates

Open
#1,822 8 comments 1 reaction 1 assignee View on GitHub

@rushilmehra is already working on this.

Since Sep 6, 2022.

A-backend E-easy help-wanted
Dominant language
Rust
Stars
1.2k
Forks
232
Avg merge
11h 35m
Merged PRs (30d)
60

Description

For situations where all the versions of a crate has been yanked you get the following error:

The requested version does not exist

when visiting the latest url:

  • https://docs.rs/$YANKED_CRATE_NAME.
  • https://docs.rs/$YANKED_CRATE_NAME/latest/.
  • https://docs.rs/$YANKED_CRATE_NAME/latest/$YANKED_CRATE_NAME/index.html.

Generally when crate authors would share links to the documentation for their crate they would share a link to the generic "latest" page. This means all of those links are dead even though the author may have pushed a final version explaining an alternative crate to use, before yanking that version too.

Real life example:
https://docs.rs/constfft/latest/constfft/
https://docs.rs/constfft/0.2.4/constfft/index.html

Suggestion: redirect to the most recent docs, even when all the versions are yanked, but add a banner that no un-yanked versions exist anymore.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.