The documentation is nowhere near so bad that I'd choose to start from scratch, definitely not.

Thanks for saying how easy it is to propose a patch through GitHub. Yes, I should give in to the urge to improve documentation (or code, but I get the feeling that the documentation isn't up to the code more often).