added feedback edits and use cases to docs