Update docs

This PR will make the guide more generic in terms of directory paths and crate information.  It also
updates some outdated output.
For better or for worse, hyphenated package names are going to be encouraged.

https://github.com/rust-lang/cargo/issues/380