Added the english documentation with the documented code to the distribution
Improved some documentation of the code.