The new readme

Clean branch with just the readme update, no merges