Revamp doc index

[steveklabnik]

Fixes #14972

[Gankra]

Maybe an aside, but I'd like to see std/index.html promoted a little higher in this page, or even to the front page. It's the most useful and accurate resource on Rust development, but is tedious to navigate to via rust-lang.org.

Edit: otherwise, this is a big improvement!

[steveklabnik]

is tedious to navigate to via rust-lang.org.

It's one click from there, isn't it?

[Gankra]

@steveklabnik d'oh, you're right. I must have been misremembering... something. Why doesn't Github have an appropriate emote for this... Camel of Shame! 🐫

I think I just end up at this page a lot after misclicks or misreads (since "API docs" and "All docs" look very similar), and have started to associate it with poor navigability. Maybe a banner at the top to the effect of "Looking for Rust API docs? Click here!".

shrug

This is still a huge improvement! 👍

[steveklabnik]

@brson any thoughts here? You opened the original issue.

[nodakai]

The link to rust.html was removed from index.md! Please revert back that part.

[steveklabnik]

@nodakai PR submitted, nice catch!