wee bit updates of the readme while waiting for more time to move docs.