Comment by wubrr
11 hours ago
Code as documentation is not nonsense at all. I do think high quality documentation should exist on it's own, but cleanly written and organized, well-commented code that is easy to read and understand is extremely valuable for many reasons. It IS a huge part of the documentation for the technical people that have to maintain the code and/or use it in advanced/specialized ways.
Yes, except this is not what people talk about when they say code is the documentation. What's meant in that context is no documentation and only code, with the idea that you can always read the code if you need to figure something out. Which, of course, is nonsense.
Nah, that's your own (incorrect) interpretation, the first result of googling 'code as documentation' [0], starts off with:
> Almost immediately I feel the need to rebut a common misunderstanding. Such a principle is not saying that code is the only documentation.
[0] https://martinfowler.com/bliki/CodeAsDocumentation.html