JSON Schema and Validation

[ste...@docuracy.co.uk]

Hello, everyone. I've just finished drafting a JSON Schema for the Linked Places format, following Karl's written specification as closely as I could, but including proposals for a few additional properties. JSON Schema provides a means to specify a data model in both human- and machine-readable form, and the schema can be enriched with descriptions and examples for each data property.

Gethin and I needed a schema for validating the datasets that we're producing for our Peripleo-based visualisation project (British Library + Rainer), but it seems to me that it could also serve as a practical basis for discussion and building on Karl's original specification. I've uploaded the draft version to GitHub here, and have embedded notes where things need some discussion. I wonder if the 'Public' repository settings will allow us to do that using the [Issues] tab without adding you all as Collaborators?

I've also produced a JSON Schema for what I'm calling at the moment xLP (Extended Linked Places), which has further additional properties (for Google indexing and CSL-JSON citations) that we may want to consider absorbing into a new standard LP. You can find that here.

None of the online validators that I've found yet supports the most recent JSON Schema draft specification: the most up-to-date one seems to be at https://www.jsonschemavalidator.net/. You can see it working on a rather messy patchwork of our data here.

All the best,

Stephen

[Stephen Gadd]

There is now an initial set of GitHub Issues here to which you are invited to contribute:

Dataset citations and indexing

Requirement for a 'when'

Depictions: fragmentSelector

Relations: sourceLabels

Link types: exactMatch

Toponym citations

Features without location data

Geometry Precision

Non-place feature types

when.timespans.start|end.in|earliest|latest

[Karl Grossner]

Thanks for this, Stephen.

We've had two emphatic votes for using GitHub issues to track discussion and work--backed up by Stephen creating these issues. I think it's time to arrange a Zoom call to orient ourselves. I will set up a poll for finding the best time(s) and publicize that in this group email list and twitter of course :^)

Karl

[Stephen Gadd]

Thanks, Karl, good plan.

And as you suggested, I've moved all of the Issues I created over to your Linked Places Format GitHub repository.