use YAML for all examples
precisely JSON-LD compatible subset of YAML http://www.yamllint.com/
@ahdinosaur gave examples which I really like in
- https://github.com/valueflows/resource/issues/3#issuecomment-216734579
- https://github.com/valueflows/process/issues/9#issuecomment-216704398
YAML serialization stays very close to nested lists approach @fosterlynn used in
Advantages of YAML
- we can parse it and reserialize (for example to use in JSON-LD Playground)
- we have clear way to give or not to give an
@id
(IRI) to each entity, which should help clarify direct vs. indirect identification - we can convert it to graph diagrams (manually first and automate it later)
Later I can write some JS using rdf-ext modules to automatically re-serialize graph, which could enable tabs for examples as we see in (plus graph diagram)
can we all agree on that?
Actually I should have made a PR to CONTRIBUTING.md instead of raising an issue...