Documentation has been added for the less obvious public and private methods.
Some of the methods in the model should be shown as private, so have
had methods refactored.