Are variable declarations properly commented?
Comments are required for aspects of variables that the name doesn’t describe. Each global variable should indicate its purpose and why it needs to be global. Are units of numeric data clearly stated? Comment the units of numeric data. For example, if a number represents length, indicate if it is in feet or meters. Are all functions, methods and classes documented? Describe each routine, method, and class in one or two sentences at the top of its definition. If you can’t describe it in a short sentence or two, you may need to reassess its purpose. It might be a sign that the design needs to be improved. Are function parameters used for input or output clearly identified as such? Make it clear which parameters are used for input and output. Are complex algorithms and code optimizations adequately commented? Complex areas, algorithms, and code optimizations should be sufficiently commented, so other developers can understand the code and walk through it. Does code that has been commented
Are variable declarations properly commented?