Best Coding Practices

Within these castle walls be forged Mavens of Computer Science ...

— Merlin, The Coder

• No global variables
• Appropriate capitalization
• Appropriate and descriptive variable names
  • nouns are usually most appropriate
• Appropriate and descriptive function names
  • verbs are usually most appropriate
• Appropriate use of functions
  • DRY: Do Not Repeat Yourself
  • DIE: Duplication is Evil
  • In general, avoid mid-function exits
• Appropriate scoping
  • Scope is no wider than absolutely necessary
• Clean loops with clearly defined exits
  • In general, avoid mid-loop exits
• Appropriate indentation
• Helpful whitespace
• Appropriate placement of closing braces and parentheses
• Appropriate use of preconditions
• Deliberate and helpful comments
  • Avoid "obvious" comments
• Avoid deep nesting
• Limit line length
• Appropriate file organization
  • Generally one class per file
• Code is clear and concise