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

[jeremyfiel]

#3837

[handrews]

The following PRs are ports of already-approved PRs and should be straightforward to merge - please consider doing so before the call to save us time!:

• #3816
• #3817
• #3820 (already approved by @ralfhandl and @miqui , but I had to resolve conflicts which reset it)
• #3839
• #3835
• #3836

These PRs are pretty straightforward and probably could be handled prior to the meeting:

• #3810 (now with a rendered view available!)
• #3822 (mostly reorganizing things, with only a few new clarifications)
• #3824
• #3837

These PRs are complex and/or will need discussion:

• #3828 (did we turn off this registry and should it stay off?)
• #3823
• #3838
• #3818

These issues need discussion:

• #3740
  • Since our allegedly normative Markdown doesn't include the references list, should we shift to the HTML rendering for citations?
  • How do we want to approach classifying and indicating normative vs informative references?
• More issues for review:
  • Meta: How many TSC opinions are necessary to take an issue out of review and work on a PR and not risk the PR being shot down by other TSCers? (of course, sometimes PRs get shot down anyway for good reasons, but in general...?)
  • #1806 (comment) (is there anything here we're going to do, or should we just close this?)
  • #3734

[frankkilcommins]

Please review and merge #3842 as part of the Arazzo Specification launch preparation 🚀

[hudlow]

Can someone with the proper authority re-open #726? There is clearly still unrest about the clarity of the license field.

[ralfhandl]

How to test changes to the gh-pages build script:

• check out PR branch
• run scripts/md2html/build.sh from the repo root
• this will create a folder deploy/oas with the HTML files inside

Only once:

• check out gh-pages branch
• copy folder js into folder deploy
• folder structure should now be
  • deploy
    • js
      • respec-oai.build.js.map
      • respec-oai.js
      • ...
    • oas
      • latest.html
      • v2.0.html
      • ...

Then open the HTML files with a browser and they will render nicely.

After that it suffices to check out the branch with the modified build script and run it, then open the HTML files with a browser.