Tracker for reorganizing the spec (started from #125 discussion)
As of commit 38956df:

• TOC
• murder the changes.md file
• introduction
• historical context (moved to ./history.md)
• terms / glossary
• conformance categories
• endpoints (nitty gritty)
• add appendix
• describe relationship to OCI images
• uses cases should link to workflows
• "image" -> "artifact"
• remove rules/requirements specific to images (blobs before configs etc)
• finalize HTTP status codes
• address Regular expressions missing for name, reference, etc. #183

the idea being that these are mergable chunks of PRs,
For readers of the spec, the spec is organized according to the nature of the reviewers (general information, slightly more detail, and registry/tool implementors).