Docs.rs: Top bar for choosing crate version / platform no longer appears

Created on 7 Jun 2018  路  8Comments  路  Source: rust-lang/docs.rs

https://github.com/onur/docs.rs/commit/4a9cb42b4c9ea8d24e0eaf51290419889117aa03 removed the top bar that allows you to choose a crate version / platform / see other info about the crate.

Maybe you can use this issue to track bringing it back when you figure out the solution to the rustdoc changes?

Most helpful comment

This should be fixed by https://github.com/onur/docs.rs/pull/217 now!

All 8 comments

Same here. I just noticed that and it is really inconvenient.

For example, now there is no way to see the winapi documentation, since it is available only under -pc-windows-msvc targets.

@onur Is there any way to revert previous behavior back? Was it worth to make such a usability breaking change, actually?

I'll try to bring it back this weekend.

@pravic new rustdoc changes did break entire top bar, I had no other choice. I'll try a different approach this time.

And yes, @GuillaumeGomez is always breaking docs.rs :-)

:-掳

Another use case for top bar is for browsing source code. Sometimes "Repository" link on crates.io points to a different version of the code compared to what is published, and you want to see the original. Also I was using this feature to look at Cargo.toml file to see what cargo features are available.

@onur Has there been any development on this?

As a workaround, you can manually navigate to the pages that the top bar linked to. Using winapi as an example:

https://docs.rs/crate/winapi/ displays the README for the latest version
https://docs.rs/crate/winapi/0.3.5/ displays the README for 0.3.5
https://docs.rs/crate/winapi/0.3.5/source/ lets you browse the source code for 0.3.5
https://docs.rs/winapi/0.3.5/x86_64-pc-windows-msvc/winapi/ displays target-specific documentation for 0.3.5

Well, thanks to https://github.com/retep998/winapi-rs, there was a direct link to the documentation: https://docs.rs/winapi/*/x86_64-pc-windows-msvc/winapi/

This should be fixed by https://github.com/onur/docs.rs/pull/217 now!

Was this page helpful?
0 / 5 - 0 ratings

Related issues

Nemo157 picture Nemo157  路  4Comments

jyn514 picture jyn514  路  5Comments

QuietMisdreavus picture QuietMisdreavus  路  4Comments

stefan-k picture stefan-k  路  6Comments

Xiphoseer picture Xiphoseer  路  4Comments