added feedback edits and use cases to docs

"error on the side”

do you mean

“***err*** on the side"