Enumerate the ways in which spec.md language/layout is unclear

[jdolitsky]

cc @pmengelbert

[jdolitsky]

related to #62

[pmengelbert]

I began a list of issues with the spec here:
https://hackmd.io/ZlKd3uzMSgC98OAwOQ3SHQ?view

It's a working document but I hope to make it more complete. The 3 things that will likely make the biggest difference are:

• Combine overview and corresponding detail sections, and carefully remove all duplications.
• Mass will be to MUST
• Rewrite all language written from client perspective to be from registry perspective
• Be more specific about what error codes should happen when
• A table of endpoints with expected response codes

[vbatts]

Related: #125

[mikebrow]

• Rewrite all language written from client perspective to be from registry perspective

so long as no detail is lost in the change of perspective...

[vbatts]

i'm closing this issue, as there are other issues opened now, with discussion on this.