One large spec.md is difficult to maintain

[edeykholt]

Pull requests for changes will be easier to resolve when they are smaller, and having smaller section .md files will help with that goal.
I suggest splitting the one spec.md into multiple files, initially along the line of one file for each major section.