Category Archives: programming

Code as Documentation: does it stack up?

The phrase “the code is the documentation” captures an idea that is somewhat controversial within the software development community. Personally, while I tacitly agree, I find it elitist and exclusionary, the barrier, being of course, the ability to “read” code to a sufficient level to be able to interpret it meaningfully. But that’s just my subjective opinion, here are some aspects that illuminate different viewpoints in a more objective and balanced manner.

Continue reading