And while I’m on the subject of documentation, here’s a great story from the former The Daily WTF.com, now known (sadly) as WorseThanFailure.com, called Very, Very Well Documented.
George’s contact at the Air Force was a gruff, old general with a vast knowledge of aerial warfare and forty years experience in the service. Naturally, he was very skeptical of the new guys’ ability to develop a ‘military grade’ product.’ After all, they hadn’t spent a single day in uniform. But George’s team quickly won him with a demonstration: one month after being awarded the contract, they had fully replicated the prototype plane’s specifications in their software. [..]
‘Gentlemen,’ the general started during one of their wrap-up meetings, ‘you have done very well. I am very impressed. There is, however, one problem. You did not provide nearly enough documentation.’ [...]
‘You see gentlemen,’ the general continued, ‘for such expensive program, we require at least eight meters of documentation.’ He stretched his arms as far as he could to illustrate. Clearly, he was not joking.
(read the rest of the story)
(I got it from The Daily WTF.)