RE #27012 Add method documentation and make methods private

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.