some doc updates
Merge pull request #1007 from ArmchairDesigner/improve-docs

some doc updates