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

Part 5: Add table of x-ogc- properties #945

Open
m-mohr opened this issue Jul 16, 2024 · 5 comments
Open

Part 5: Add table of x-ogc- properties #945

m-mohr opened this issue Jul 16, 2024 · 5 comments
Assignees

Comments

@m-mohr
Copy link
Contributor

m-mohr commented Jul 16, 2024

I think it would be valuable to add a table of all the pre-defined additions to JSON Schema, i.e. with the x-ogc- prefix.
It would help to understand schemas more easily, especially as some schemas consist of more proprietary properties than JSON Schema vocabulary.

PS: Generally, it feels like the number of additions to JSON Schema is a bit excessive.

@pvretano pvretano self-assigned this Jul 29, 2024
@pvretano pvretano moved this from To do to To be drafted in Features Part 5: Schemas Jul 29, 2024
@pvretano
Copy link
Contributor

SWG Meeting 29-JUL-2024: Yes, all present agreeds that a table of x-ogc- values would be useful. @pvretano will add.

@jerstlouis
Copy link
Member

jerstlouis commented Oct 16, 2024

In addition to having a table in the Standard, it might be worthwhile to set up some kind of registry so that additional fields can be registered for different use cases, after the Standard has been published. cc. @rob-metalinkage @avillar

See opengeospatial/NamingAuthority#315

@jerstlouis
Copy link
Member

I've created a Wiki page on the OGC API - Common repo to keep track of the x-ogc-* extension keywords until the Naming Authority sets up a register for them:

https://github.com/opengeospatial/ogcapi-common/wiki/Table-of-extensions-to-the-JSON-Schema-vocabulary

I used ASCIIDoc so hopefully this can serve as a starting point to address this issue as well.

cc. @ghobona @rob-metalinkage @joanma747 @fmigneault @m-mohr

@m-mohr
Copy link
Contributor Author

m-mohr commented Dec 6, 2024

I appreciate the effort. IMHO it underlines my point about the excessiveness of these additions and that it feels more and more like OGC Schema with some JSON Schema rather than JSON Schema with some OGC extensions.

@jerstlouis
Copy link
Member

@m-mohr I disagree mainly in the sense that the vanilla JSON Schema provides all of the essential functionality (mainly the field names, data type, titles, description), whereas clients aware of the additional OGC-specific extensions can leverage the additional information.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Status: To be drafted
Development

No branches or pull requests

4 participants