22 Nov
2011
22 Nov
'11
4:56 p.m.
On 22/11/11 3:51 PM, Eric Smith wrote:
Jason McBrien wrote:
You bet. There's a *reason* why pilots use long written checklists - no
matter what their age or self-confidence.
--Toby
I've found the following to be true:
1 - If you wrote the code, even if it's undocumented, you are
going to be likely to know what it does when reviewed later on
You must have a much better memory than most people. My experience,
which matches that of every programmer I've spoken to about this, is
that any code I wrote but last looked more than three years ago takes
very nearly as much effort to understand as code of comparable quality
by another author but which I've never seen before.
That means that I find it worthwhile to document code well even if I
think that the only audience for that documentation is my future self.