Hacker News new | ask | show | jobs
by nulldata 2118 days 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.
1 comments

I 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.
I think I've heard "the code is self-documenting" a hundred times in my career and it hasn't been true once.
Yup, look at any driver in the Linux kernel.