Video tutorials¶
Five short episodes, each building on the one before, from first principles to the Python library. They are silent: the text on screen carries the script, so they work with the sound off.
Every episode is also a slideshow. Use View as slideshow to step through the same beats as stills, at your own pace, which is usually the better way to read the code.
1. Why data needs meaning¶
Why a schema on its own is not enough. A schema constrains the shape of your data and says nothing about what it means; a context supplies meaning and says nothing about shape.
2. Anatomy of an OO-LD document¶
A close reading of Minimal.schema.json, keyword by keyword: $schema, $id, @context, and the ordinary JSON Schema keywords beside them.
3. Building objects from objects¶
Composition: $ref for reuse, allOf for extension, and what happens to the @context when schemas compose. See Composition for the written version.
4. Identity, instances and the graph¶
How instances get identity, how an instance plus its schema's context expands into triples, and how a set of documents becomes a graph. See Schema Instances and Identification & Versioning.
5. oold in Python¶
Putting it to work with the oold reference library: the graph-object binding, links, validation, and the DSL.
Source¶
The episodes are authored in code, in media/tutorials in this repository, and rendered in a light and a dark cut from the same source. The stills behind the slideshow are the same frames the reviewers look at in every pull request.