Missing code comments

The code contains very few comments to document each functionality.
Code comments should be added on every file and public methods as well as in critical areas.
Also the size of some methods should be reduced by breaking the code down in more manageable private methods.
This would make the project easier to work on by external contributors and more maintainable in the future.