Comment

Often, software development teams work together on different software modules, which are inspected by testing engineers during the testing process. During the process of testing, the engineers have to be aware of the workings of a module. Hence, comments are included by the developer to explain the workings of a particular module by stating the valid types of inputs, the number of inputs, the algorithm used for processing in the internal module, the expected outputs and the error conditions that may be encountered during processing.

Comments also often provide information regarding the author of the content, the date and time it was developed and the date and time it was last modified. How much detail to include is a matter of subjectivity. Some developers are notorious for hating comments and view them as a waste of time. To others, comments are an absolute necessity. In theory, an organization should lay all its coding standards. Still, for whatever reason, anybody who has inherited code from a previous development team will tell you more times than not that the code does not have the commenting they would of liked to see.