‪It means writing code that is completely self-documenting.‬

‪It means writing code that is completely self-documenting.‬

‪It also means staring at a webpack config file for hours not knowing what any of it means.‬

4 thoughts on “‪It means writing code that is completely self-documenting.‬

  1. Whenever I hear the words “self documenting,” I am reminded of the hours and hours I spent reading through Emacs manuals trying to figure out how to do simple things like show line numbers, enable auto-indent, and disable the automatic code formatting. while getting zero work done throughout the day.

    Like

  2. Actually I remember the term from a syntax/semantics workgroup where we programmed in Prolog, which was declarative. The syntax was the program, and that’s cool when you are into syntax. That doesn’t mean that syntax is easy though.

    Like

  3. Pieter Lamers Rich Hickey, creator of Clojure has a talk online in which he talks about the difference between “easy” and “simple”. Easy is how close the problem solution is to your current skill set while Simple is how to solve a problem in the least complicated way. These are not interchangeable concepts because creating simplicity often requires acquiring new skills.

    Like

Leave a comment