Another documentation pull request

Hello folks, 

I am totally confused with all the banches and git and if you too are seeing some changes in comments (for documentation purposes) then I think I am on the right path. If the changes I have submitted are not in feature-apidoc as well as master, please merge it. No logic has been changed - only comments.

Best Regards