The documentation problem

The first problem with good documentation is that no one wants to do it, so it never gets done.

The second problem is that once it’s made, no one remembers to refer to it. Since no one refers to it, no one wants to create it. And around we go.

If you want documentation to happen, you have to stop treating it as a side project, a second class citizen. Documentation should be a required step for shipping any new work.