Writing documentation for tools that others will need to run over the Christmas break. I remain convinced that documentation is a great way to spot the usability flaws in the tools I write. The question then turns into one of priorities: should I fix the tool, or just explain the flaws in the docs?