Development Guidelines

Developers spend 3 times more time understanding code than modifying it, and 5 times more time modifying code than writing new code. For this reason, it's important that we make our code as easy to understand as possible by following certain company guidelines.

Code Guidelines

• Use spaces, not tabs. Specifically, use 4 spaces instead of a tab.

• Avoid lines longer than 79 characters

• When using braces (e.g. {}), use mitred braces. For example:

    myFunction({
        //something
    });
  
    if (x) {
        //something
    } else {
        //something
    }
  

• Constants tend to be IN_ALL_CAPS

• Don't leave commented out code in your commit if the code is already in version control:

  • Comments are for explanations / design decisions

• Otherwise, we defer to various language standards:

  • Python:
    • CamelCase for classes, underscore_notation for pretty much everything else.
    • The Zen of Python (PEP 20)
    • Style Guide for Python Code (PEP 8) (example)
    • DocString conventions (PEP 257)
  • Javascript:
    • CamelCase for classes, hungarianNotation for everything else.
    • Use "use strict"; wherever possible: What does "use strict" do?
    • Semicolons are not optional
    • Use one-line comments (e.g. //) unless you are writing machine-directives (e.g. JS lint, doxygen, tests)
    • Douglas Crockford's Javascript Guidelines