rustdoc: improve sidebar, add to crate root page, add tooltips

[liigo]

• Add sidebar to crate root index.html, to preview the structure of
  the crate quickly.

  If there are too many documents in the crate root, such as log
  index.html, you can't find any informations of its mods and types,
  unless and untill you scroll down to the bottom of the page.

• Add tooltips to links of sidebar, showing shortened doc-comments.

Preview:
http://liigo.com/tmp/rust/doc/std/index.html
http://liigo.com/tmp/rust/doc/log/index.html

[alexcrichton]

This deviates from the current design that the current module's items are at the bottom while the containing module's items are on the left. This puts everything on the left for exactly one thing, the crate, while everything else still "suffers" by having things at the bottom. I would prefer that we stay consistent rather than special casing one level of the hierarchy.

[liigo]

If no sidebar in crate root page, users always "suffers" by have to scroll
down to find some items to navigate to.

In non-root pages, uses can always navigate from sidebar. But in root
pages, there's no sidebar. It was inconsistent.
2014年3月19日 下午11:26于 "Alex Crichton" [email protected]写道：

This deviates from the current design that the current module's items are
at the bottom while the containing module's items are on the left. This
puts everything on the left for exactly one thing, the crate, while
everything else still "suffers" by having things at the bottom. I would
prefer that we stay consistent rather than special casing one level of the
hierarchy.

—
Reply to this email directly or view it on GitHubhttps://github.com//pull/13014#issuecomment-38064151
.

[alexcrichton]

In non-root pages, uses can always navigate from sidebar

Yes, they can navigate the parent's contents, not their contents. The root page navigates the directory of crates, which it currently does.

[liigo]

This makes difficulty in use. People open std/index.html, must scroll down and search items from long text.

2014年3月20日 上午7:24于 "Alex Crichton" [email protected]写道：

In non-root pages, uses can always navigate from sidebar

Yes, they can navigate the parent's contents, not their contents. The
root page navigates the directory of crates, which it currently does.

—
Reply to this email directly or view it on GitHubhttps://github.com//pull/13014#issuecomment-38119832
.

[alexcrichton]

It sounds like you're describing what you think is a general problem with rustdoc. You have fixed it in one case here, not in all cases. It will be expected that all pages have their contents on the left, not just the root page.

[liigo]

I got it. I'll try to update this PR. Thank you!

[alexcrichton]

Closing due to inactivity, but feel free to reopen with a rebase!