Update to readme.md

Some proposed initial changes to the readme to give a very quick intro and links out to the docs. All new content pulled in from other locations in the repo; will be cleaning up all pages over the next little while.
Note that an overview issue, #2633, has been filed.