added feedback edits and use cases to docs

Definitely do mean that -- fixing.