Rewrite the spec in proper markdown.

Just to aid readability on Github.