Commenting Routines Keep comments close to the code they describe Describe each routine in one or tow simple sentences at the top of the routine Document parameters ...

General Guidelines when it comes to using comments These sections are based on the book "Code Complete 2", Chapter 32, Self-Documenting code Arguments Pro Con of ...