[x3d-public] JSON Schema Work In Progress Feedback and X3D preparations

John Carlson yottzumm at gmail.com
Mon Jun 10 07:09:48 PDT 2019

Please review JSON schemas 3.0-4.0 in the specifications folder.  These are old versions.  New versions are maintained in X3DJSONLD/src/main/schema, and generated from the shell folder using gen… something.   The python called from shell is called etgenerateschema.py found in the python folder.

If you want to do a smaller schema first, provide a simpler X3DUOM.   Thanks!


Sent from Mail for Windows 10

From: Brutzman, Donald (Don) (CIV)
Sent: Monday, June 10, 2019 8:15 AM
To: John Carlson
Cc: X3D Graphics public mailing list
Subject: Re: JSON Schema Work In Progress Feedback and X3D preparations

On 6/9/2019 12:00 PM, John Carlson wrote:
> Note, the next draft will not be called draft-08 when published.
> So we should probably stop calling that draft that.

No worries.  Their current labeling is

	"Next Draft (by whatever name)"
	"We have typically referred to this as draft-08"

So we can continue to simply use whatever they say their name is.  IETF will likely guide them, there are lots of procedures and policies there for draft document naming.

> See link for more details.
> I haven’t seen any software implementations (validators) yet.
> Ajv looks like it’s getting a new repository on GitHub.

Agreed that getting good JSON Schema validator support is key next step for our X3D JSON testing.  We will be providing them excellent feedback regarding whether it is working.

Wondering, if you want to simplify the editing chores for evolution of our X3D JSON schemas, then if "draft-08" has a lot of changes then we might simply focus on Interchange profile support.  That is testable and a lot smaller.  Once we have a good design pattern, it is time to "turn the crank" and automate production of full JSON schemas for X3D versions 3.0 thru 4.0.

Once valid schemas are in hand, we then install the revised JSON schema validator of choice, and can then finally apply our already-available automated validation of schemas and 2900 X3D .json models themselves.  Boom presto, lather-rinse-repeat until full validity is achieved.

> FYI,
> John

thanks for tracking this John!

> Sent from Mail <https://go.microsoft.com/fwlink/?LinkId=550986> for Windows 10
> *From: *Brutzman, Donald (Don) (CIV) <mailto:brutzman at nps.edu>
> *Sent: *Friday, June 7, 2019 7:45 AM
> *To: *X3D Graphics public mailing list <mailto:x3d-public at web3d.org>
> *Cc: *John Carlson <mailto:yottzumm at gmail.com>
> *Subject: *JSON Schema Work In Progress Feedback
> https://json-schema.org/work-in-progress
> =======================================
> The Next Draft (by whatever name) Is Ready for Final Pre-Publication Review!
> The forthcoming draft is now feature-frozen and entering the final four-week feedback period before publication. This final review will last from May 27th to June 24th, 2019.
> The timeline may be compressed if, after at least two weeks, there is a clear consensus that the drafts are solid and it would be best to publish sooner rather than later.
> The following sorts of feedback are particularly desired:
>       Clarity, readability, and accessibility to new readers
>       Contradictions, inconsistencies and other bugs
>       Anything so egregious that implementation would be infeasible or impossible
> New features or major changes to existing features will be deferred to a future draft, and work on the next draft will begin immediately after this one is published.
> =======================================
> Looks like the time has finally come for work on updating our X3D JSON Schema (originals authored by Roy Walmsley, updates by John Carlson) for JSON draft-08!

all the best, Don
Don Brutzman  Naval Postgraduate School, Code USW/Br       brutzman at nps.edu
Watkins 270,  MOVES Institute, Monterey CA 93943-5000 USA   +1.831.656.2149
X3D graphics, virtual worlds, navy robotics http://faculty.nps.edu/brutzman

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://web3d.org/pipermail/x3d-public_web3d.org/attachments/20190610/85e4ddf1/attachment-0001.html>

More information about the x3d-public mailing list