add spec and link to spec in README

Clarified some of the README and transferred the spec back to markdown.
All future changes to the spec will be accompanied by a changelog note.
I literally have no idea what anything in this sentence means.