clean up comments to be more concise/uniform
Merge pull request #1616 from bricejlin/patch-1

clean up comments to be more concise/uniform