Why We Don’t Document Code

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 to navigate