Overhaul all docs

Major improvements to the README.md and all supporting doc/ files.