Update the readme to be current, and move more content into `/docs` folder
Update the readme to be current, and move more content into
/docsfolder