Improved the critical inline documentation of the top level package and the model subpackage