Why We Don’t Document Code

By Deane Barker • 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 356 items.

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