News for hackers. Stuff that matters.
Re:Fred P. Brooks has passed away by ethbr0 on Friday November 18, 2022 @08:49AM (#33654596)
The dream of self-documenting code requires solving two problems, only one of which programmers are typically good at.

1) Communicating with computers

2) Communicating with other humans

Self-documenting code is essentially writing prose. Granted, to someone with similar knowledge as you.

But most people suck at writing.

Re:Fred P. Brooks has passed away by Ma8ee on Friday November 18, 2022 @12:59PM (#33658850)
I have better hope that a good programmer can write readable code, than that they will write readable documentation. As you point out, people suck at writing.