6 Matching Annotations
  1. Sep 2022
    1. Good code is its own best documentation. As you’re about to add a comment, ask yourself, "How can I improve the code so that this comment isn’t needed?". Improve the code and then document it to make it even clearer.
  2. Mar 2021
    1. The absence of a method name here is per design: this object does only one thing, and hence what it does is reflected in the class name.
  3. Feb 2021
  4. Nov 2020
    1. One last bonus: CSS variables can be written in a way that makes it easier for human programmers to understand. If you just see hex code #93e9be, you won’t know what color it produces, while --brand-green makes clear the purpose of the variable.
  5. Nov 2019
    1. There's no technical reason why you couldn't detect enum columns at startup time and automatically do this wireup, but I feel that the benefit of self-documenting outweighs the convenience.