None of us are wild about writing docs, but they're very important, and there's a number of improvements we need to make. Sub-issues for details: