Entities becomes ProvEntities

Author: bclenet

provenance_dcm2niix/README.md

@@ -1,21 +1,28 @@
-# BEP028 example dataset - Provenance records for `dcm2niix`
+# Provenance of DICOM to Nifti conversion with `dcm2niix`
 
-This example aims at showing provenance records for a DICOM to Nifti conversion, performed by [`dcm2niix`](https://github.com/rordenlab/dcm2niix
-). Provenance records were created manually ; they act as a guideline for further machine-generated records by `dcm2niix`. 
+## Goal
 
-After conversion, and adding provenance traces, the directory tree is as follows:
+This example aims at showing provenance metadata for a DICOM to Nifti conversion with [`dcm2niix`](https://github.com/rordenlab/dcm2niix
+). Provenance metadata was created manually ; its acts as a guideline for further machine-generated provenance by `dcm2niix`. 
+
+## Source data
+
+That the `sourcedata/` directory contains the source dataset (DICOM files) known as [hirni-demo](https://github.com/psychoinformatics-de/hirni-demo).
+
+## Directory tree
+
+After conversion, and adding provenance traces, the directory tree is as follows. Files marked with a ✍️ were generated manually.
+`sub-02/anat/sub-02_T1w.json` was generated by `dcm2niix`, then the `GeneratedBy` and `SidecarGeneratedBy` provenance-related fields were added manually.
 
 ```
-prov/
-├── prov-dcm2niix_act.json
-├── prov-dcm2niix_ent.json
-├── prov-dcm2niix_env.json
-└── prov-dcm2niix_soft.json
+✍️ prov/
+├── ✍️ prov-dcm2niix_act.json
+├── ✍️ prov-dcm2niix_ent.json
+├── ✍️ prov-dcm2niix_env.json
+└── ✍️ prov-dcm2niix_soft.json
 sourcedata/
 sub-02/
 └── anat
-    ├── sub-02_T1w.json
+    ├── ✍️ sub-02_T1w.json
     └── sub-02_T1w.nii
 ```
-
-Note that the `sourcedata/` directory contains the source dataset (DICOM files) known as [hirni-demo](https://github.com/psychoinformatics-de/hirni-demo).

provenance_dcm2niix/prov/prov-dcm2niix_ent.json

@@ -1,5 +1,5 @@
 {
-  "Entities": [
+  "ProvEntities": [
     {
       "Id": "bids::sourcedata/hirni-demo/acq1/dicoms/example-dicom-structural-master/dicoms",
       "Type": "Entity",