added feedback edits and use cases to docs
Merge pull request #12 from jtmoulia/doc-feedback

added feedback edits and use cases to docs