Chad Dickerson wrote a piece titled, "Documentation Dilemma," that got me thinking about writing and maintaining documentation.
You can read Ambler’s complete essay for yourself, but if I could pick the part of his approach that I most identify with, I would choose these sentences: “The best documentation is the simplest that gets the job done. Don’t create a 50-page document when a five-page one will do. Don’t create a five-page document when five bullet points will do. Don’t create an elaborate and intricately detailed diagram when a sketch will do. Don’t repeat information found elsewhere when a reference will do. Write in point form. Document only enough to provide a useful context.”
I hate to write documentation, even for myself. But on certain tasks, I have started to write checklists with POD. If find POD simple to use and it gets the job done.