Skip to content

Commit bf2f544

Browse files
committed
move json comma callout to metadata description section
1 parent 97adeee commit bf2f544

File tree

1 file changed

+16
-2
lines changed

1 file changed

+16
-2
lines changed

episodes/03-metadata-descriptor.md

Lines changed: 16 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,22 @@ but they have two different functions.
3737
The context brings the defined terms into the metadata document,
3838
while the conformance declares which RO-Crate conventions of using those terms are being followed.
3939

40+
:::::::::::::::::::::::::::::::::::::::: callout
41+
42+
## Adding entities to the JSON array
43+
44+
Because we're adding incrementally to the `@graph` array.
45+
It is important to remember the comma `,` between each entity,
46+
**except** for the final entity in the JSON array;
47+
and likewise for the properties within the JSON object for each entity.
48+
This is an artefact of the strict [JSON](https://www.json.org/) file format rules to simplify parsing.
49+
The order of the entities within the `@graph` JSON-LD array
50+
and the order of the keys within a JSON object is _not significant_.
51+
The _graph_ content is given by the `@id` cross-references.
52+
53+
You will add a comma here between the `ro-crate-metadata.json` entity, and the root data entity.
54+
::::::::::::::::::::::::::::::::::::::::::::::::::
55+
4056
::::::::::::::::::::::::::::::::::::::: callout
4157
## RO-Crate versions
4258
This tutorial is written for RO-Crate 1.2,
@@ -52,5 +68,3 @@ may still be subject to changes and should only be used with caution.
5268
- RO-Crate specifications are versioned
5369
- The version of RO-Crate is indicated using the conformsTo property
5470
::::::::::::::::::::::::::::::::::::::::::::::::::
55-
56-

0 commit comments

Comments
 (0)