Hyper-schema Draft 04 changed...

[Allan Schrum]

Sorry that I'm joining late but I'm trying to understand why the hyper-schema draft 04 schema changed, primarily by adding a new links section at the end.

http://json-schema.org/draft-04/hyper-schema

I'm trying to find the discussion and reasoning for this change and what its impact might be on those existing implementations using the older schema.

Thanks,

-Allan

[Henry Andrews]

Hi Allan,

  Could you be a little more precise about what you think changed and when?  Looking back into the repository as of May 2016 (well before any post-draft-04 changes were done AFAIK), I don't see any substantial difference (at some point, the whitespace format changed).

  The links in draft-04 look like this:

    "links": [

        {   

            "rel": "self",

            "href": "{+id}"

        },  

        {   

            "rel": "full",

            "href": "{+($ref)}"

        }   

    ]   

which I think is correct and always has been (but I don't understand the preprocessor rules in draft-04 so I'm really not sure)

thanks,

-henry

---

From: Allan Schrum <allan....@gmail.com>
To: JSON Schema <json-...@googlegroups.com>
Sent: Friday, September 29, 2017 7:16 AM
Subject: [json-schema] Hyper-schema Draft 04 changed...

--
You received this message because you are subscribed to the Google Groups "JSON Schema" group.
To unsubscribe from this group and stop receiving emails from it, send an email to json-schema...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.

[Henry Andrews]

Also, what implementation of hyper-schema are you using?  JSONary is the only actual hypermedia implementation of which I'm aware, (although there are several documentation generation tools built on top of hyper-schema other than that).

thanks,

-henry

---

From: 'Henry Andrews' via JSON Schema <json-...@googlegroups.com>
To: "json-...@googlegroups.com" <json-...@googlegroups.com>
Sent: Friday, September 29, 2017 5:54 PM
Subject: Re: [json-schema] Hyper-schema Draft 04 changed...

[Allan Schrum]

Sometime between 16-Sep-2017 @6:13AM and 19-Sep-2017 @6:26AM these lines were added to the schema found in the standard URL (as well as white-space differences that I'm ignoring). We have a unit test that downloads the schema once a day to track possible changes. At that time the "links" section was added to the schema.

We are using a custom implementation for the code dealing with the schema. What I'm trying to understand is why the change was made and what is its intent.

Thanks,

-Allan

[Henry Andrews]

That was probably when we switched the web site repo from having independent copies of the meta-schemas to using submodule references to the specification repository.  So it wasn't intended to be a change.  AFAIK that "links" section was always supposed to be there. and if it was missing that was a bug.  It just makes the hyper-schema meta-schema a hyper-schema on its own, which can identify it's own URI.  Which is nice more for philosophical consistency than anything else.

Other than being unexpected, does it cause problems?  If not, then you can safely move on.

BTW this will be relevant to monitoring for changes: https://github.com/json-schema-org/json-schema-spec/issues/430

Our expectation is to only ever update those meta-schemas with actual bug fixes.  The change you saw has to do with weird decisions to duplicate the files in the past, which let them get out of sync with the spec.

thanks,

-henry

---

From: Allan Schrum <allan....@gmail.com>
To: JSON Schema <json-...@googlegroups.com>

Sent: Monday, October 2, 2017 12:25 PM
Subject: Re: [json-schema] Hyper-schema Draft 04 changed...

[Henry Andrews]

Just as a heads up, we will (probably) push a bug fix for the draft-04 meta-schemas, feel free to comment if you have any concerns.  This just brings the meta-schemas in line with the specification, so it *shouldn't* cause problems.

https://github.com/json-schema-org/json-schema-spec/pull/436

There's a smaller fix for draft-06 (default value of "readOnly" was the string "false" instead of the literal false - oops) posted as well.

thanks,

-henry

---

From: Allan Schrum <allan....@gmail.com>
To: JSON Schema <json-...@googlegroups.com>

Sent: Friday, September 29, 2017 7:16 AM

Subject: [json-schema] Hyper-schema Draft 04 changed...