Added diagram source in plantuml format to make it easier to edit

Author: ptsefton

Makefile

@@ -1,2 +1,4 @@
 md:
-	node make-profile.js ; pandoc profile/profile.md -o profile/test.html
+	plantuml profile/media/*.puml -tsvg
+	node make-profile.js
+	pandoc profile/profile.md -o profile/test.html

profile-text/profile.md

@@ -66,7 +66,7 @@ The structural elements of a Language Data Commons RO-Crate are:
 
 - A Collection / Object hierarchy to allow language data to be
   grouped - for example a corpus with sub-corpora, or collections of
-  items (objects) from a particualr region.
+  items (objects) from a particular region.
 
 - Dataset and File entities (as per RO-Crate). Files may be referenced
   locally or via URI - eg from an API. If an RO-Crate contains files
@@ -85,7 +85,7 @@ A conformant RO-Crate:
 
 ${rules.Dataset}
 
-![](media/image4.png)
+![](media/structure.svg)
 
 A collection such as a corpus may be stored in a repository or
 transmitted either as
@@ -101,15 +101,15 @@ Distributed Collections MAY reference member collections or Objects in
 hasMember property but SHOULD NOT include descriptions of Objects that
 are stored elsewhere in the repository.
 
-![](media/image2.png)
+![](media/bundled-crate.svg)
 
 Objects MUST be linked to collections using memberOf and MAY
 additionally be linked to collections using hasMember references.
 
 Which linking strategy is used is an implementation choice for
 repository developers.
 
-![](media/image5.png)
+![](media/distributed-crates.svg)
 
 ## When to choose collection-as-crate ("bundled") vs collection-in-multiple crates ("distributed")
 
@@ -204,7 +204,7 @@ the object and its files (and the contextual metadata of a Person who
 takes the role of the speaker/informant (discussed in more detail
 below).
 
-![](media/image1.png)
+![](media/object-structure.svg)
 
 There are a number of terms that can be used to characterize resources -
 these use the schema.org mechanism of DefinedTerm and DefinedTermSet.

profile/media/bundled-crate.puml

@@ -0,0 +1,39 @@
+
+@startuml
+title: Self contained corpus crate with all resources
+package "ROCrate: My Corpus" {
+   rectangle "RepositoryCollection: MyCorpus" as cc {
+
+   }
+   rectangle "RepositoryObject, Dialogue: #1" as o1 {
+
+   }
+   rectangle "RepositoryObject, Dialogue: #2" as o2 {
+
+   }
+   rectangle "File, Audio:  files/audio1.wav" as a1
+   rectangle "File, OthographicTranscription: files/csv1.csv" as csv1
+   rectangle "Dataset: files" as files
+
+
+
+   rectangle "RepositoryCollection: Collection A" as c2 {
+
+   }
+   cc -down-> c2 : hasMember
+
+   c2 -down-> o1 : hasMember
+   c2 -down-> o2 : hasMember
+
+   o1 -down-> a1 : hasPart
+   o1 -down-> csv1 : hasPart
+
+
+   cc -down-> files : hasPart
+   files -down-> csv1 : hasPart
+   files -down-> a1 : hasPart
+
+
+}
+
+@enduml

profile/media/bundled-crate.svg

@@ -0,0 +1,50 @@
+
+@startuml
+title: Complete corpus collection metadata-only crate w/ links to object packages
+package "name My Corpus" as mc {
+   rectangle "@type: [Dataset, RepositoryCollection]\nconformsTo: ./#Collection" as cc {
+
+   }
+}
+
+package "ROCrate: Collection A" as cAc {
+
+   rectangle "@type:  [Dataset, RepositoryCollection]\nconformsTo: ./#Collection" as ca {
+
+   }
+  
+}
+
+
+package "ROCrate: Collection B" as cBc {
+
+   rectangle "@type:  [Dataset, RepositoryCollection]\nconformsTo: ./#Collection" as cb {
+
+   }
+  
+}
+
+
+package "RO Crate: Interview #1" as ec2 {
+  rectangle "@type: RepositoryObject\nconformsTo: ./#Object\nmodailty: Speech\nlingusiticGenre: Interview" as eo1 {
+
+   }
+   rectangle "@type: [File, PrinaryText]:  files/audio1.wav" as ea1
+   rectangle "@type: [File, Annotation]: files/csv1.csv" as ecsv1
+   }
+
+
+
+eo1 -down-> ea1 : hasPart
+eo1 -down-> ecsv1 : hasPart
+
+eo1 -up-> ca : memberOf
+ca -up-> cc : memberOf
+cb -up-> cc : memberOf
+
+note right of cc : Repository Collection:\n- MUST contain descriptive metadata\n  for the corpus/collection\n- MAY contain hasMember relationships\n  listing child Collections or Objects
+
+ 
+note bottom of ec2 : Individual object with file data
+
+@enduml