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

Open TSC Meeting, Thursday April 2nd 2020 #2188

Closed
MikeRalphson opened this issue Mar 30, 2020 · 3 comments
Closed

Open TSC Meeting, Thursday April 2nd 2020 #2188

MikeRalphson opened this issue Mar 30, 2020 · 3 comments

Comments

@MikeRalphson
Copy link
Member

NOTE: This meeting is on Thursday at 9am - 10am PT
Zoom Meeting link: https://zoom.us/j/975841675

In order to give some more visibility into the topics we cover in the TSC 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 TSC meeting

Topic Owner Decision/NextStep
$schema in Schema Object Someone
ReadOnly / WriteOnly TSC
Continue: discriminator (Live or Die)? TSC

/cc @OAI/tsc Please suggest items for inclusion

@Relequestual
Copy link
Contributor

FYI discriminator is part of JSON Schema Language JSON Data Definition Format JSON Type Definition: https://github.com/jsontypedef and has caused confusion for one StackOverflow user this week: https://stackoverflow.com/questions/60959556/using-discriminator-keyword-in-json-schema?noredirect=1#comment107861479_60959556

@darrelmiller
Copy link
Member

Notes from meeting:

  • We should add text to identify the schema as using the OpenAPI vocabulary with URI as the Id. The Id could be, https://spec.openapis.org/oas/3.1/schema-object This conversation can continue in the spec channel.
  • Schema objects should be assumed to identify as using the $schema of the id defined in the last bullet point.
  • For external tools to process the JSON Schema as using an OpenAPI vocabulary users would need to include this id in the schema.

@darrelmiller
Copy link
Member

Discussed readOnly/writeOnly. Acknowledged that to be compatible with JSON Schema we do need to make what could be considered a breaking change. We need to investigate the impact of this change as we believe it would primarily affect people who use request payload validators that are OAS aware. We are not sure they actually exist.

@MikeRalphson MikeRalphson unpinned this issue Apr 14, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

4 participants