some tweaks to documentation/comments
Merge pull request #24 from RallySoftware/cleanup-docs

some tweaks to documentation/comments