Move the readme content into spec.md
new readme
adjustments