docs: improve grammar, clarity, and code examples and API docs#548

stevenh merged 3 commits intorobertkrimen:masterrobertkrimen/otto:masterfrom

dev-kas:masterdev-kas/otto:masterCopy head branch name to clipboard