Skip to content
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

Documentation for 0.8.5 is missing/broken #1528

Open
marmeladema opened this issue Nov 18, 2024 · 9 comments
Open

Documentation for 0.8.5 is missing/broken #1528

marmeladema opened this issue Nov 18, 2024 · 9 comments
Labels
X-bug Type: bug report

Comments

@marmeladema
Copy link

Summary

https://docs.rs/crate/rand/latest reports rand-0.8.5 doesn't have any documentation.

See
Screenshot 2024-11-18 at 10 23 30

This is making working with the rand crate relatively difficult as various links, even from the rand book, points to latest version.

A workaround is to look at the previous version documentation at https://docs.rs/rand/0.8.4/rand/index.html

@marmeladema marmeladema added the X-bug Type: bug report label Nov 18, 2024
@benjamin-lieser
Copy link
Collaborator

It seems packed_simd broke with the current compiler and so did the docs.
I am not sure if it can be fixed after the fact though

@dhardy
Copy link
Member

dhardy commented Nov 18, 2024

But curious that it got rebuilt; you can see that the previous build was Feb 14, 2022.

@dhardy
Copy link
Member

dhardy commented Nov 19, 2024

Fixed

@dhardy dhardy closed this as completed Nov 19, 2024
@ranile
Copy link

ranile commented Nov 19, 2024

@dhardy I don't see the fix? It's still broken on docs.rs. https://docs.rs/rand redirects to https://docs.rs/crate/rand/latest. The last build (one day ago) failed: https://docs.rs/crate/rand/0.8.5/builds/1555579

@benjamin-lieser
Copy link
Collaborator

benjamin-lieser commented Nov 19, 2024

It is here https://docs.rs/rand/0.8.5/rand/index.html

There was no fix (which would require a new version, so potential problems for people for no use at all)

The old documentation was somehow restored. I guess docs.rs will eventually fix these things. See rust-lang/docs.rs#2675

@Imberflur
Copy link

For some reason all the source links for the 0.8.5 docs on docs.rs point to https://rust-random.github.io. Which was really confusing me since the source there is for a different version 😅. Is this related?

@dhardy
Copy link
Member

dhardy commented Dec 4, 2024

For some reason all the source links for the 0.8.5 docs on docs.rs point to https://rust-random.github.io. Which was really confusing me since the source there is for a different version 😅. Is this related?

Which links in particular? The "source" link on https://docs.rs/rand/latest/rand/ shows code packaged from that release.

https://rust-random.github.io doesn't link to anything. https://rust-random.github.io/rand/rand/ is built from the master branch (equivalent to the 0.9.0-beta.1 release for now).

@Imberflur
Copy link

Which links in particular? The "source" link on https://docs.rs/rand/latest/rand/ shows code packaged from that release.

at least the source links on this trait https://docs.rs/rand/latest/rand/trait.SeedableRng.html (permanent link https://docs.rs/rand/0.8.5/rand/trait.SeedableRng.html)

I didn't realize it was just some of the source links. It looks like at least a few other traits are affected.

@dhardy
Copy link
Member

dhardy commented Dec 4, 2024

Aha. It sounds like the docs restoration got messed up.

Thanks for reporting; I don't know if we'll fix soon however.

@dhardy dhardy reopened this Dec 4, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
X-bug Type: bug report
Projects
None yet
Development

No branches or pull requests

5 participants