/readme.md - documentation rewrite, and minor corrections.