4 ms·
That's not necessarily the same thing though. Verbosity can obscure the information you're trying to gather from the code you're reading. A "can't see the fores
by nulldata 6y ago
That's not necessarily the same thing though.
Verbosity can obscure the information you're trying to gather from the code you're reading. A "can't see the forest for the trees"-kind deal.
- johnisgood 6y agoI cannot see the source code for the documentation. This happens to me in so many cases. I work with a couple of codebases that have 90% documentation, 10% code. In Ada, code IS the documentation that also can be formally verified. It is wonderful.
- NationalPark 6y agoI think I've heard "the code is self-documenting" a hundred times in my career and it hasn't been true once.
- Lucretia9 6y agoYup, look at any driver in the Linux kernel.