documentation additions, corrections
Merge pull request #65 from Postmedia/documentation_updates

documentation additions, corrections