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

Article Proposal: JSON Schema bundling finally formalised #11

Closed
Relequestual opened this issue Jun 15, 2021 · 7 comments
Closed

Article Proposal: JSON Schema bundling finally formalised #11

Relequestual opened this issue Jun 15, 2021 · 7 comments

Comments

@Relequestual
Copy link

I've written an article covering the bnundling process for JSON Schema.

The idea for this article came about after a discussion on twitter where I suggested the approach to merging external schemas had the potential to cause real problems.

While the article doesn't directly address the use case for code or form generation, it does present best practrice to form an ideal situation for standardised bundling of external JSON Schema resources into a single resource (or file). The bundling process results in a Compound JSON Schema Document, which is formally defined in JSON Schema draft 2020-12, and is also one of my largest direct contribution to the specification.

The article is already written and undergone a level of peer review.

@MikeRalphson has "topped and tailed" the article to provide a little context for OpenAPI readers.

My intent is to publish the article under a new soft launched JSON Schema blog, and if you're willing, cross post to the OpenAPI blog (and possibly a few others for increased visiblitly).

I'm not totally sure of the process here, but I'm ready to share a draft for review and feedback.
Please let me know how you'd like to proceed.

@kinlane
Copy link
Collaborator

kinlane commented Jun 17, 2021

I will bring up in the OAI marketing meeting and ask about 1) interest in the story, and 2) cross posting -- worse case on this is we'll have to write an OAI specific edition, which I am willing to help with.

@Relequestual
Copy link
Author

Has there been a OAI marketing meeting since? Looking to publlish next week now, hopefully.

@kinlane
Copy link
Collaborator

kinlane commented Jul 6, 2021

Hey now. I only initially presented this to the OAI Marketing, and dropped ball as I was out of office. I can pick up this Friday, but it will take more time and editorial before it can be approved. What were your syndication strategy for this post? We can follow up in our Sync.

@Relequestual
Copy link
Author

No problem. I'm planning to create a self coded (template repo based) self hosted (netlify) JSON Schema blog, and manually cross post to dev.to and hashnode. Possibly also to @philsturgeon API's you won't hate blog if he's still up for it.

I don't know if the OAI marketing group will then still want the cross posting to the OAI blog, but it's still possible and would be welcome =]

@philsturgeon
Copy link
Collaborator

Absolutely, I'd love a guest post on this for APIs You Won't Hate.

@kinlane
Copy link
Collaborator

kinlane commented Jul 10, 2021

@Relequestual -- Thumbs up from OAI marketing meeting to publish this to OAI blog, even if it is cross-posted to multiple locations. Is it ready for OAI editorial to look at?

@kinlane
Copy link
Collaborator

kinlane commented Nov 22, 2021

@kinlane kinlane closed this as completed Nov 22, 2021
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
@kinlane @philsturgeon @Relequestual and others