Added code comments
Fixed documentation of method signatures
Merge pull request #832 from DanielSWolf/documentation

Documentation fixes