D.3 Comments (number of semicolons matters)

• All comments should be complete sentences with capitalization and a period.
• 3 (or 4) semicolons at the beginning of a line for block comments outside of any top level form
• 2 semicolons for comments that appear between lines of code
• 1 semicolon for comments that appear after code at the end of a line
• vertical align end-of-line comments when possible
• always use a space after the last semicolon and before comment text
• In Emacs M-; inserts a comment of the appropriate type.