Documentation patches, revert change rejected on PR #013

https://github.com/zettio/weave/pull/103#issuecomment-58236794