"Almost all programmers type fast, say 400+ characters
per minute. So how long does it take to write one two
lines of simple text explaining your code? 15 seconds
maybe?"
OMG - is this true? He can't be talking about code - can he? I'm lone programmer & self taught. If it's true I must really suck because it takes me so much longer it's not funny. LoL - I have to stop and think, for minutes, almost all the time.
I don't usually have to stop and think for documentation, though. That's the idea - you're just putting down what's already in your head so that the maintainer can read it.
That said, I usually find that the documentation I write ends up becoming out-of-date about 5 minutes after I write it, because code changes in the process of writing it down. I might write down a docstring to clarify my thoughts, but then the function I actually write doesn't do exactly what I thought it would, and I have to go back and remove or cleanup the docstring later.
