Singular shorthand for requests & responses

[rattrayalex]

paths:
  "speakers":
    request:
      method: post
      contentType: application/json
      contentSchema:
        $ref: "#/components/schemas/speaker"
      response:
        status: 201

as shorthand for:

paths:
  "speakers":
    requests:
      default:
        method: post
        contentType: application/json
        contentSchema:
          $ref: "#/components/schemas/speaker"
        responses:
          default:
            status: 201

I imagine this has been discussed internally previously.

This would be a bit annoying to consume from tooling, and complicates the spec, but could be much nicer to maintain by hand in >50% of cases (perhaps >80%?) if combined with a proposal to allow encoding the HTTP method in the path:

paths:
  "post /speakers":
    request:
      …

This helps the apparent goal of Moonwalk of flattening the spec substantially (typically one level of indentation for the request, and two levels of indentation for the response).

This proposal also reduces the burden on the developer of coming up with names, which is among the hardest things in computer science.