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.
yep, I'll probably rewrite that to be much more informative and error-free