Skip to content

The schemas are (mostly) not metaschemas #4189

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

Merged
merged 1 commit into from
Nov 12, 2024
Merged

Conversation

handrews
Copy link
Member

@handrews handrews commented Nov 11, 2024

OpenAPI schemas are not metaschemas. Well, the bits for the Schema Object are, but the overall OAS is more important and it's already driving me bonkers to see these described as "metaschemas." An OAD is not a JSON Schema, so these schemas are just schemas. (yes, I am fixating on something fundamentally unimportant, please let me have this small nitpick thx)

@handrews handrews added Schema Housekeeping script Pull requests that update Bash or JavaScript code labels Nov 11, 2024
@handrews handrews requested review from a team as code owners November 11, 2024 20:12
@ralfhandl
Copy link
Contributor

What about

* `https://spec.openapis.org/oas/3.1/meta/base/{date}` — The vocabulary metaschema for OAS 3.1's extensions to draft 2020-12
* `https://spec.openapis.org/oas/3.1/dialect/base/{date}` — The dialect metaschema that extends the standard `draft/2020-12` metaschema by adding the OAS "base" vocabulary

Is "metaschema" used correctly there?

@ralfhandl ralfhandl requested a review from a team November 12, 2024 12:13
@handrews
Copy link
Member Author

@ralfhandl yes, those are metaschemas. But from the point of view of most users, they are implementation details, and either schema or schema-base is "the schema"

@ralfhandl
Copy link
Contributor

Merging as it only affects a github workflow

@ralfhandl ralfhandl merged commit 9e548a1 into OAI:main Nov 12, 2024
2 checks passed
@handrews handrews deleted the non-meta branch March 29, 2025 17:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Housekeeping Schema script Pull requests that update Bash or JavaScript code
Projects
Status: Done
Development

Successfully merging this pull request may close these issues.

2 participants