Fix class name formatting
Better integrate dangling sentence into paragraph
Merge pull request #1571 from philippm/smaller-doc-fixes

Smaller doc fixes