Doc minor fixes

Fixes some of the quirks I came across while reading the documentation