Posts tagged docs
Documentation is JSON for the Brain
- Feb 13 2017
When you are writing software, you build a mental model of the program in your brain. This is how you make decisions and reason about how the program might work, how data flows, or what designs make the most sense.
“My Code is Self-Documenting”
- Jan 27 2017
Self-documenting code is one of the biggest documentation myths in the software industry. This view generally conflates documentation with code comments. I’d like to make two arguments in this post:
A Selfish Appeal for Documentation
- Sep 24 2016
Writing code is the act of building a mental model of a problem, and then translating that model into executable software.
Hey there! I'm Eric and I work on communities in the world of software documentation. Feel free to email me if you have comments on this post!