search

lbovet / docson

Documentation for your JSON types
Apache License 2.0
491 stars 97 forks source link

Does docson support JSON schema v7. #75

Open pirahana opened 5 years ago

pirahana commented 5 years ago

Hi, I have a json schema which is not working fine with docson. I guess some problem with additional properties or with v7 update of json schema. Attaching the json schema for reference.

sample.txt

Made it txt to attach it. Convert the extension to .json to validate the docson package.

handrews commented 5 years ago

Note that JSON Schema draft 2019-09 (formerly known as draft-08) has been published.

This is the draft that will likely be used by OpenAPI 3.1 (see https://github.com/OAI/OpenAPI-Specification/pull/1977).

pirahana commented 5 years ago

I dont get what do you want to iterate @handrews , are you suggesting that I should move to JSON-schema draft 2019-09 and it will solve the problem.

handrews commented 5 years ago

@pirahana I'm just noting that if you're looking at new draft support, there is a newer draft than draft-07. I figured I'd mention it because it was literally published last week and people probably aren't that aware of it yet.

Also, since your README talks about Swagger (now known as OpenAPI), I thought you might be interested that the newest draft is what OpenAPI is likely to move to. There is no version of OpenAPI that officially worked with draft-06 or draft-07. Both Swagger/OpenAPI 2.0 and OpenAPI 3.0 more or less work with draft-04 (there was no draft-05 for... reasons).

What you do with this information is up to you.

pirahana commented 5 years ago

Ok, I get it . Thanks @handrews for the elaboration.