markup literal strings in the documentation

Also, fix wording and add TODO.