Henry Andrews

@ralfhandl is the CONTRIBUTORS.md file actually used for anything or does it just sit there separate from the spec publishing process?

@lornajane agreed, I've filed OAI/OpenAPI-Specification#4148 to track.

We should definitely add "OpenAPI Description" (OAD) to the style guide as that's what we settled on calling the things that people write that conform to the OpenAPI Specification (OAS)....

Switching this to draft because I've almost merged it twice now.

@ralfhandl I realize I am asking for a substantially more complex workflow, so I took a pass at it. I was going to use the "suggest" feature on this PR...

@stueynz (assuming you're still paying attention after all these years...) there is a [proposal for 3.2](https://github.com/OAI/OpenAPI-Specification/blob/main/proposals/2024-09-01-Tags-Improvement.md) that adds a `summary` field to the Tags Object, which would work for both...

this is only "not planned" in the sense of not doing a specific `label` field for the External Documentation Object. The proposed `summary` field is still slated for 3.2 and...

Thanks, @philsturgeon ! See also: * #2236 * #3528 * #3529

@karenetheridge The `parameters` option you suggest would be for a zero-length request body, but not for the response body. You can set that header in a Response Object: ```YAML "201":...

@karenetheridge yup, I was just re-formatting it for a response. And we will definitely do something about that by 4.0.