Update README for clarity and adherence to the style guide

Flesh out sections for completeness and clarity. Updated the TOC. Update the examples for adherence to the style guide.
Add puppet code types to readme
Merge pull request #104 from hunner/readme

Readme