Open Community (TDC) Meeting, Thursday 06 June 2024 about openapi-specification

[handrews]

• 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: 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
• Patch Releases: editorial / release checklist
  • #2660 (do we want to try to sort this out in the patch releases or not?)
• GitHub pages site (spec.openapis.org):
  • #3717 (@frankkilcommins has requested that we make it a separate repo instead of a directory here; I am in favor so that the spec-specific part is clearly in each spec repo, and the common part is not in any one spec's repo)
  • #3868 (migrating to a directory, so if we decide "no" to the above question, we should see if we can approve this)