Open Community (TDC) Meeting, Thursday 02 February 2023

[github-actions]

NOTE: This meeting is on Thursday at 9am - 10am PT

Zoom Meeting link: https://zoom.us/j/975841675. Dial-in passcode: 763054 - Code-of-Conduct

In order to give some more visibility into the topics we cover in the TDC meetings here is the planned agenda for the next meeting. Hopefully this will allow people to plan to attend meetings for topics that they have an interest in. And for folks who cannot attend they can comment on this issue prior to the meeting. Feel free to suggest other potential agenda topics.

Please submit comments below for topics or proposals that you wish to present in the TDC meeting

The agenda backlog is currently maintained in issue #2482

Topic	Owner	Decision/NextStep
Broken Markdown links
Separation of concerns in OpenAPI
Reports from Special Interest Groups	TDC
AOB (see below)	TDC
New issues / PRs labelled review	@OAI/triage
New issues without response yet	@OAI/triage

/cc @OAI/tsc Please suggest items for inclusion

[darrelmiller]

Topic for this meeting: How do we separate concerns in OAS in order to manage complexity?

[ralfhandl]

Housekeeping: how to repair the broken links in the spec markdown files, see for example issue #3132.

Apparently GitHub changed the way it treats anchors embedded in headlines, for example

#### <a name="schemaObject"></a>Schema Object

This used to copy the anchor element verbatim to the HTTP output, and links such as [Schema Object](#schemaObject) worked fine.

Now the anchor name is prefixed with user-content-, resulting in

<a name="user-content-schemaObject">

and all links broken.

This also affects the document at https://spec.openapis.org/oas/latest.html, try for example the links in this "Fixed Fields" table. These links now only scroll the table of contents on the left and no longer jump to the referenced section.

[frankkilcommins]

@ralfhandl I'm due to talk to @MikeRalphson about this. I'm happy to fix assuming I know the pipeline expectations

[darrelmiller]

Action: Darrel to go hunting in GitHub about anchor naming change

[darrelmiller]

I did some spelunking about the broken links thing and ended up here gjtorikian/commonmarker#229