Skip to content

Commit 4cab3ca

Browse files
committed
Criteria for supporting other specifications
From today's TDC call: changes related to supporting other specifications need to show that those specifications are actually being used.
1 parent 1be009f commit 4cab3ca

File tree

1 file changed

+5
-2
lines changed

1 file changed

+5
-2
lines changed

DEVELOPMENT.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -74,11 +74,14 @@ Bigger changes require a more formal process.
7474
2. It really helps to see the proposed change in action.
7575
Start using it as a `x-*` extension if that's appropriate, or try to bring other evidence of your proposed solution being adopted.
7676

77-
3. If the suggested change has good support, you will be asked to create a formal proposal.
77+
3. If you are adding support for something from another specification (such as OAuth), please point to implementations of that
78+
specification so that we can understand how, and to what degree, it is being used.
79+
80+
4. If the suggested change has good support, you will be asked to create a formal proposal.
7881
Use the [template in the proposals directory](https://github.com/OAI/OpenAPI-Specification/tree/main/proposals), copy it to a new file, and complete it.
7982
Once you the document is ready, open a pull request.
8083

81-
4. The proposal will be more closely reviewed and commented on or amended until it is either rejected or accepted.
84+
5. The proposal will be more closely reviewed and commented on or amended until it is either rejected or accepted.
8285
At that point, the proposal is merged to the `main` branch and a final pull request is opened to add the feature to the appropriate version of the specification.
8386

8487
Questions are welcome on the process and at any time. Use the discussions feature or find us in Slack.

0 commit comments

Comments
 (0)