CMSC Coding Standards Summary

Coding standards make up 15% of each programming project. Although every attempt is made to summarize each coding standard, some may have been inadvertently left off this list. It is your repsonsibility to read and understand the complete coding standards document.

Minor deviations from the standard carry a 1 or 5 point deduction depending on how many infractions are found.
Major deviations from the standard carry a 5 or 10 point deduction depending on how many infractions are found.
Serious deviations from the standard carry a 10 or 15 point deduction depending on how many infractions are found.

For example, if 1 to 3 function name(s) does/do not follow the function naming convention, expect a 1-point deduction. If more than three function names fail to follow the function naming convention, expect a 5-point deduction.

You should expect to have points deducted from your project score for each of the following line items.

Minor Infractions (1 or 5 points)

1. use of file extensions other than .cpp and .h
2. primary file ( the one with main() ) not named projN.cpp (e.g. Proj1.cpp)
3. executable not named ProjN (e.g. Proj3)
4. .h files not guarded
5. unnecessary inclusion of header files
6. failure to follow naming conventions for
   • class names
   • class data members
   • class methods
   • variables
   • functions
7. use of poorly named variables, constants or functions
8. function prototypes with unnamed parameters

   Major Infractions (5 or 10 points)

9. multiple classes defined in one header file
10. multiple classes implemented in one .cpp file
11. multiple private and/or public sections in class definition
12. insufficient or improper use of const for parameters and methods
13. insufficient or improper use of reference parameters
14. default values for parameters not specified in the prototype
15. use of magic numbers and magic strings
16. improper use of single-letter variable names
17. code that is unreadable
    This would include such items as
    • insufficient use of blank lines
    • insufficient use of spaces
    • improper/inconsistent code indentation
    • in-line comments improperly indented or improperly placed
    • insufficient in-line comments in the code
    • comments that belabor the obvious
    • comments that contradict the code
    • invalid style for braces
18. incomplete or missing file header comments
19. incomplete or missing function header comments, in particular missing or meaningless pre- and post-conditions
20. unhandled function pre-conditions
21. class methods performing input or output

    Serious Infractions (10 or 15 points)

22. class method(s) implemented in header file
23. class data members that are not private
24. use of global variables