fix up some docs reported by community members

Trello card - https://trello.com/c/E8CGGy0c/29-fix-documentation