Method Documentation

In each public method, the following standards are to be observed as per the example below:

• a description for each parameter must be entered in the upper area
• In the method, at the top, is a description of the purpose of the method
• The parameters are repeated in text format as part of the method so that when a method is over-ridden, the parameter description will be copied into the over-ridden method.
• If there is an expected return value, document those at the top of the method

Also indicate if this method should never be over-ridden except in rare cases, could be overridden, or should be overridden.