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.