Why We Don’t Document Code

Posted on September 06, 2013

Documentation is always the last thing anyone wants to do. In general, we all hate it, and software we wrote – even software that’s not one-off, but is specifically intended for the future use of other people – generally never gets documented.

Right now, I’m sitting on a software library that I wrote which painfully needs documentation.  But I haven’t written it.  I’ve been encouraged to write it, and it sorely needs to be written, but I...just...don’t.

I got to wondering why this is.  After a week of soul-searching, here it is, for better or worse:

Is there a solution to this?  I don’t think so.  If there was, I suspect we’d have found it by now.

Now, if you’'ll excuse me, I need to get back to avoiding documenting some code.

This is item #53 in a sequence of 357 items.

You can use your left/right arrow keys or swipe left/right to navigate