Open Community (TDC) Meeting, Thursday 30 May 2024 about openapi-specification

[handrews]

• Governance/process/editorial things listed in a specific order this week:
  • #3576 (officially make the HTML renderings the citable source of truth, because they are the only ones with the full contents and we should be able to rearrange our repo to suit our development needs)
  • #3854 (consolidate examples that aren't in the specification text in one place as, it's confusing to manage example-related issues spread across the spec repo and the learn site, and different contributors could help with examples than with the spec)
  • #1806 (are we doing anything from this or can we close it?)
  • #2950 (should we add the Security Considerations to 3.0.4 and 3.1.1? If not, is this done and can we close it?)
  • #1965 (repeat the full list of relevant Parameter Object fields under Header Object or leave as-is?)
  • #2660 (do we want to try to sort this out in the patch releases or not?)
• Patch Releases: referencing and identification
  • This week, we really need to resolve the implicit connection PRs, as I have two alternatives to choose from:
    • #3823 (defines two approaches for two different ways to arrange multi-document OADs)
    • #3856 (defines a single recommended approach)
  • #3838 (3.1 URL vs URI usage was not well-explained)
  • #3860 (we can't just remove the weird Path Item $ref behavior in a minor release)
  • #3858 (relative links in CommonMark text)
• Patch Releases: discriminator
  • #3846 (needs resolution so I can backport merge differences)
• Patch Releases: parameters and encoding
  • #3849 (nitpicky but important- how serialized examples work)
    • This is blocking resolution of #3041 to include serialization examples in Parameter Object example(s) fields in the spec
  • #1322 (I'm not sure deepObject has a clear explanation, but we should clarify this weird gap where the default explode: false is not defined)
  • #1663 (need clarity around style/explode and "n/a")
  • #3818
  • #3840
  • #3841
  • #3857
  • #3859

[darrelmiller]

Action: Create a sig-industry-standards repo to maintain a list of organizations who are using OpenAPI to define standards.
Action: Add older specifications to the root page of specs.openapis.org