Updates to the JSON Schema - symlinks and root description#285
Updates to the JSON Schema - symlinks and root description#285frankkilcommins merged 1 commit intoOAI:v1.0.0-devfrom
Conversation
| @@ -1,7 +1,7 @@ | |||
| { | |||
| "$id": "https://spec.openapis.org/arazzo/1.0/schema/2024-08-01", | |||
There was a problem hiding this comment.
we may also want to consider the $id WORK-IN-PROGRESS for schema development purposes. Overlay and OAS have included changing this to the deployment date with a build script on merge
There was a problem hiding this comment.
@frankkilcommins Should the JSON version be removed?
OAS only maintains the YAML representation and produces the JSON representation on-the-fly when publishing the schema.
There was a problem hiding this comment.
Arazzo doesn't have the full publishing process just yet
There was a problem hiding this comment.
Happy to remove once the automation is setup.
ralfhandl
left a comment
There was a problem hiding this comment.
Looks good, WORK-IN-PROGRESS marker and removal of JSON representation can be done in subsequent PRs.
|
Should be merged after #289 and the resulting publishing PR in the OAS repo. |
ralfhandl
left a comment
There was a problem hiding this comment.
@jeremyfiel please remove the JSON representation
it's been removed in #286 |
There was a problem hiding this comment.
Happy to remove once the automation is setup.
$commentsymlinksThis PR assumes we will follow OAS and Overlay in providing
$commentmetadata in the schema which points to symlinks on the spec site.symlinks need to be updated on the main openapis.org site to support the changes here: