adding final changes
Merge pull request #328 from rackerlabs/constanze2

adding final changes to clean up the doc