Improve the project documentation

Improve the Javadoc of the classes and of the public methods.