Improved documentation of the project, refs #309