Update the FAQ and some documentation styles

Closes rust-lang/crates.io#21
Closes rust-lang/crates.io#29
Closes #882
auto merge of #901 : alexcrichton/cargo/update-faq, r=brson

Closes rust-lang/crates.io#21
Closes rust-lang/crates.io#29
Closes #882