Comment layout

• Comments SHOULD be written in the english language.
• Comments SHOULD NOT contain spelling errors, whatever language they are written in. However, omitting comments is no substitute for poor spelling abilities.
• There SHOULD NOT be any single-line comment.

  Rationale: if the comment is short, then the code should have been self-explanatory in the first place.

• The delimiters in multi-line comments MUST appear on their own line. Intermediary lines are aligned with the delimiters, and start with **:

  /* * Incorrect */ /* Incorrect */

            
  
            /*
            ** Correct
            */
            
            

  
  

For additional specifications about comments, see File layout and Global specifications.