Make docs.rs documentation more visible on website

[XAMPPRocky]

There is documentation for docs.rs' crate metadata in the source, but it isn't accessible from the website, which makes hard for users to find. It would be nice if there was a page on the website that explained what metadata you can and should set.

[XAMPPRocky]

I missed that this is available under "about docs.rs" under "Rust". Though it wasn't obvious to me that, that's where I should be looking.

[Nemo157]

I have long thought the location of "about docs.rs" was really weird and annoying to find, feel like reopening this as making it more obvious somehow? (Maybe the current about page should be split into "about docs.rs" and "docs.rs documentation"? And the top-level menu renamed somehow?)

[XAMPPRocky]

Yeah I think it would be good to split the website's about to the top level of the nav.

[jyn514]

@Kixiron plans to work on this as part of #740.

[jyn514]

@XAMPPRocky we split this up in #924. How does it look now?

[XAMPPRocky]

It looks good to me, aside from the fact that the top bar is radically different when you're looking at a crate vs docs.rs pages on mobile. I would expect them to be consistent.

Home

Crate

[jyn514]

Hmm well I agree the design is pretty inconsistent, but the information is different on those two pages. On the main page, it's information about docs.rs itself, while on /crate it's information about that specific crate. This is the same page on desktop so you can see the titles:

Maybe we should consider adding the labels on mobile too? Or adding the docs.rs header to /crate and rustdoc pages?

[jyn514]

@XAMPPRocky we redid this again in #1089. What do you think now?

Main page:

Rustdoc pages:

/crate pages:

[XAMPPRocky]

@jyn514 Looks great! I found a minor bug where the gear icon doesn't work on tap on iOS if there's no targets, but it's nice and consistent now.

[jyn514]

Awesome! Can you open a new issue for the iOS bug?

[jyn514]

Actually - I think that might be intentional, there's no platforms to display if there's no targets. The bug is that we still display the dropdown, not that it doesn't do anything.