This is a sketch of the committed shape for downstream tooling, gated on the deferred identification redesign. Not a normative spec fragment.
paths: # MAP keyed by RFC6570 uriTemplate (C005)
"speakers":
requests: # MAP keyed by friendly request name
createSpeaker:
method: post
contentType: application/json
contentSchema: { $ref: "#schemas.Speaker" } # by-NAME ref, never by index
responses: # MAP keyed by friendly response name; status is a FIELD
created:
status: 201
# optional presentation order, absent-by-default (lowered-ceiling hybrid):
# created: { status: 201, order: 10 }
pathResponses:
notFound: { status: 404, contentType: application/http-problem }
apiResponses:
serverError: { status: "5XX", contentType: application/http-problem }
# closed 5-member vocabulary; single body needs no wrapper, no invented key
query: { type: object, properties: { } }
path: { type: object, properties: { } }
header: { }
cookie: { }
body: { $ref: "#schemas.CreateSpeaker" }
# 3.2 (array, #/tags/1 is reorder-fragile):
# tags: [ { name: speakers, description: ... } ]
# v4 (keyed, enables $ref-to-tag):
tags:
speakers: { description: ..., kind: ... }
#/components/... by-key JSON Pointers keep resolving (components stays a map).#schemas.Foo type+name, #72 namespace:componentName, whether internal JSON Pointers survive) is DEFERRED to #26/#49/#72/#73 — the #schemas.Speaker form above is illustrative only.