This is my vain attempt to write good documentation when I find it lacking elsewhere.