Add some comments

It is a work in progress. I only did that for a single class so you can tell me if this is a good idea, if the content is missing something.
Any comments are welcome.
Fix typo
Add a todo
Add comments on the stat controller
Change todo align
Merge pull request #630 from aledeg/comments

Add some comments