in reply to Too much documentation?
Over the years I've noticed that I've become a little bit schizophrenic about documentation. For example, the first thing I do when evaluating someone elses code is to create a copy without comments at all. I'd rather see what the code is doing without being distracted by what the author thought it was doing! On the otherhand, I prefer to code using some form of Literate Programming (see Knuth) whenever I can. I think that this kind of contradiction demonstrates that this is a hard topic!
hsm
|
|---|