Finish readme.md

proof of concept/diffs in a branch