I wrote a blog post over on the &yet blog about documentation. Go check it out.