fixing comments that is slightly confusing
Merge pull request #3373 from enelson/master

fixing comments that is slightly confusing
Updated documentation to use new table of contents feature