OAI / OpenAPI-Specification

The OpenAPI Specification Repository
https://openapis.org
Apache License 2.0
28.91k stars 9.07k forks source link

Open Community (TDC) Meeting, Thursday 07 March 2024 #3614

Closed github-actions[bot] closed 6 months ago

github-actions[bot] commented 7 months ago

NOTE: 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.

Zoom: https://zoom.us/j/975841675, dial-in passcode: 763054

Participants must abide by our Code-of-Conduct.

F10B5460-B4B3-4463-9CDE-C7F782202EA9

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 TDC
New issues needing attention @OAI/triage

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

AxelNennker commented 7 months ago

I would like to talk about Add OAuth2 metadata url. Especially which document and branch this change might go into. I created a PR but that was for the wrong branch and @handrews suggested waiting with a new PR until there is some discussion on the issue to open a PR. I was not able to attend the last community meeting, so the issue was not discussed.

handrews commented 7 months ago

Process:

Mechanical:

For follow-up:

lornajane commented 7 months ago

Quick note on the proposal process after today's discussion. We should start new ideas off as discussions on this repository, once general agreement is reached, those ideas can become a proposal in a pull request. The proposal has a formalised format, which means we can then use it to make changes to the specification, so it's a good outcome. The idea is to have something that just needs polishing once it's in proposal format.

AxelNennker commented 7 months ago

"discussions" as in https://resources.github.com/devops/process/planning/discussions/ , right? I only used discussion once in another repository and was ignored. Then I created an issue on what I wanted to discuss and the conversation started.

How about having "Open Community (TDC) Meeting" agenda building as a discussion and not as an issue like this #3614 one?

handrews commented 7 months ago

@AxelNennker

I only used discussion once in another repository and was ignored. Then I created an issue on what I wanted to discuss and the conversation started.

We've had that problem in the past because the roles of discussions, issues, PRs, etc. were not well-defined. This is us starting to define them, based on how we are using them in the OAI/sig-moonwalk repository (which has the advantage of a fresh start).

How about having "Open Community (TDC) Meeting" agenda building as a discussion and not as an issue like this https://github.com/OAI/OpenAPI-Specification/issues/3614 one?

We are already trying this out in OAI/sig-moonwalk for the Tuesday meetings. If that works out well, we might standardize on that, but folks are used to the issues in this repository and there's no need to disrupt that unless we really think it would be better.