How to reword README and docs text so developers actually get it

Most docs aren't wrong. They're written by the person who knows the code best, at the moment they...