RWIB Mission 5: Documentation Page

[brson]

Link.

Today, the documentation landing
page lives in the Rust tree, and
is generated for each release channel. As Rust grows though, more
documentation lives out of tree and needs to be discoverable.

Let's reorganize this so that the website itself is the main landing
page for finding docs.

Start by moving the contents of the existing documentation index into
rust-www, reducing the existing doc index to links to the in-tree
docs, as well as a link to the website for more information.

Add a link to the new website-based FAQ.

Brainstorm about other documentation we might want to link to and what
standards of quality and stability we might require before officially
endorsing them.

[ghost]

I would like to take this on after #193.

[brson]

@efindlay You got it! Thanks!

[ghost]

It looks like my first step should just be a pure refactor with no visible changes (except for URL). I'm guessing the tricky part will be finding and changing links to the current documentation landing page. I'd like to confirm that links to

1. https://doc.rust-lang.org/std/
2. https://doc.rust-lang.org/nightly/
3. https://doc.rust-lang.org/
   should all point to one page.

[ghost]

Set of possible links:

https://doc.rust-lang.org
https://doc.rust-lang.org/
https://doc.rust-lang.org/index.html
https://doc.rust-lang.org/nightly
https://doc.rust-lang.org/nightly/
https://doc.rust-lang.org/nightly/index.html
https://doc.rust-lang.org/stable
https://doc.rust-lang.org/stable/
https://doc.rust-lang.org/stable/index.html

[ghost]

Grepped with,

git grep -En 'doc.rust-lang.org[^/]'
git grep -En 'doc.rust-lang.org/[^a-z]'
git grep -En 'doc.rust-lang.org/index.html'
git grep -En 'doc.rust-lang.org/nightly[^/]'
git grep -En 'doc.rust-lang.org/nightly/[^a-z]'
git grep -En 'doc.rust-lang.org/nightly/index.html'
git grep -En 'doc.rust-lang.org/stable[^/]'
git grep -En 'doc.rust-lang.org/stable/[^a-z]'
git grep -En 'doc.rust-lang.org/stable/index.html'

[ghost]

Oh. Only links were part of #![doc ... html_root_url = https://doc.rust-lang.org/nightly/ which doesn't need to change, does it?

[brson]

This is done.