Update README with structure, details

This commit updates the README file with a standard structure, index,
more examples, and type/provider notes.
Merge pull request #12 from reidmv/readme_update

Update README with structure, details