On 2 May 2008, at 5:31pm, Philip Brown wrote: > Having the original engineer spend 5 minutes on documentation, can > save some > later person looking at the code, 5 *days*.
For a piece of code that will take me 5 days to understand I can't write useful documentation in 5 minutes. I'm not sure how much useful documentation I can write about anything in 5 minutes. Perhaps I'm alone in that, but I doubt it. In any case, I'm sure that everyone will agree that our code should be better documented. That's somewhat tangential to the 'private interfaces' debate.
