Added comments to reflect the notes mentioned in issue #511
Merge pull request #603 from waterbearlang/511_adding_documentation

Added comments to reflect the notes mentioned in issue #511