Update stale docs

Updated and rebased version of https://github.com/jclouds/jclouds-site/pull/68, adding some changes based on review comments.

/cc @jdaggett