Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

OAS 3.1 - The Smaller List of Actualities #2025

earth2marsh opened this issue Oct 3, 2019 · 1 comment


Copy link

commented Oct 3, 2019

Much progress has been made since The Big List of Possibilities #1466 was created 18+ months ago! Now as we head toward an actual 3.1 release, it is time to collect together all of improvements that may not be backwards compatible. The following is a list of the issues in scope for 3.1, and they should be considered launch blockers until each related PR has been approved and merged into 3.1.0-dev.

  • Update Schema Objects to JSON Schema Draft 2019-09 #1977
  • Mutual Auth Certificate Support #1004
  • "Scopes" on Security Requirements for schemes other than OAuth2 #1393 #1366
  • CSV-serialized form-data arrays #2018
  • Realign the language for versioning the spec with actual intent (issue #2019 ?)
  • Resolve the SemVer ambiguities in #2022

We anticipate at least one release candidate (RC) on the path to the actual release.

Known issues that could be included but might not make the 3.1 release:


This comment has been minimized.

Copy link

commented Oct 16, 2019

As a follow-on to #1977, there needs to be some decision over how $schema should be used in the context of OAS. See issue #2017 which uses PR #2016 (starting point for a schema for OAS 3.1) as an example.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
None yet
2 participants
You can’t perform that action at this time.