Some simple comment updates
Merge pull request #708 from psav/docs_updates

Some simple comment updates