Documentation fixes from pre-release testing

Doc improvements suggested by @pwalczysko