Vim/STYLE.md
Jason Poon e568fbda37 Fix Docs (#807)
Fix docs
2016-09-27 23:16:48 -07:00

1.2 KiB

Style Guide

In addition, to VS Code's coding guidelines, please adhere to the following:

  • Use for ... of whenever possible

    Rationale: for ... of is awesome. It's more readable than any other variant.

  • Don't use any as much as possible

    Rationale: The language is called TypeScript, not UntypedScript. 😉 Static typing is wonderful. It catches bugs and improves readability. We should strive to use it as much as possible.

  • Use const wherever possible.

    Rationale: Instead of reading const as "constant value," read it as "single assignment." Yes, it means "constant value" in other programming languages, but it's a little different in JavaScript.

  • When we can't use const, use let; never var

    Rationale: var trips up programmers in a number of cases - hoisting and closure capture are two big ones. Consider the difference between

    for (var j = 0; j < 5; j++) { setTimeout(() => console.log(j), 5) }
    

    and

    for (let j = 0; j < 5; j++) { setTimeout(() => console.log(j), 5) }
    

    Even if you're not capturing the variable, who knows if someone else might later?