Open Community (TDC) Meeting, Thursday 15 August 2024

[github-actions]

Weekly meetings happen on Thursdays at 9am - 10am Pacific

This agenda gives visibility into discussion topics for the weekly Technical Developer Community (TDC) meetings. Sharing agenda items in advance allows people to plan to attend meetings where they have an interest in specific topics.

Whether attending or not, anyone can comment on this issue prior to the meeting to suggest topics or to add comments on planned topics or proposals.

Meetings take place over Zoom: https://zoom.us/j/975841675, dial-in passcode: 763054

Accessibility & Etiquette

• Participants must abide by our Code-of-Conduct.

• Meetings are recorded for future reference, and for those who are not able to attend in-person.

• We invite you to feel comfortable to challenge any language or behaviour that is harmful or not inclusive during this meeting.

• We look forward to your participation, but please consider these acts of etiquette:

  • Remain on mute when not speaking to prevent interruptions.
  • Blur your background to reduce visual distractions.
  • Use the Zoom meeting "Raise Hand" feature to notify the group when you wish to speak.

Blur My Background	Raise Hand

Agenda Structure

Topic	Owner	Decision/NextStep
Intros and governance meta-topics (5 mins)	TDC
Reports from Special Interest Groups (5 mins)	SIG members
Any other business (add comments below to suggest topics)	TDC
Approved spec PRs	@OAI/tsc
Active Projects	@OAI/openapi-maintainers
New issues needing attention	@OAI/triage

/cc @OAI/tsc please suggest items for inclusion.

[ralfhandl]

Publishing process

• Build script: no local biblio, use only Specref ids #3992 - prepare for 3.0.4 and 3.1.1 cleaned markdown
• Build script: improved code blocks #4006 - no empty line at start of code blocks, code blocks in TAB sequence
• Build script: improved syntax colors #4008 - syntax colors with higher contrast
• Build script: source-of-truth #4009 - "This version" link in frontmatter, designated as source-of-truth in text
• gh-pages: specification version lists on landing page #4013

3.0.4

• 3.0.4: replace "property" with "field" or "keyword" where appropriate #4020

3.1.1

• Clarify security; state what [] means #4007

3.2.0

• Markdown updates for 3.2.0 #4025 - port of Markdown updates for 3.1.1 #3991
• 3.2.0: minor nits #4026 - port of 3.1.1: minor nits #4014

learn

• Add pages for OAD examples learn.openapis.org#105 - this will allow linking to examples on our learning site

[baywet]

I'm double booked this week again and won't be able to join.
But this fix should be trivial to process (even async before hand if possible)
#4015

[mikekistler]

I've opened a PR that adds a Markdown Style Guide to CONTRIBUTING:

• Add markdown style guide to CONTRIBUTING #4027