linked-rolls 0.74.0 → 0.76.0

package/lib/schema.json

@@ -340,7 +340,7 @@
                 {
                     "properties": {
                         "@annotation": {
-                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                             "properties": {
                                 "belief": {
                                     "$ref": "#/definitions/Belief",
@@ -373,7 +373,7 @@
                 {
                     "properties": {
                         "@annotation": {
-                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                             "properties": {
                                 "belief": {
                                     "$ref": "#/definitions/Belief",
@@ -412,7 +412,7 @@
                 {
                     "properties": {
                         "@annotation": {
-                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                             "properties": {
                                 "belief": {
                                     "$ref": "#/definitions/Belief",
@@ -456,7 +456,7 @@
             "description": "A derivation names the version another one was derived from, together with the tolerance the two were collated at. How precisely the copies put a symbol depends on what they are and on how their features were obtained, so the tolerance can differ from derivation to derivation.",
             "properties": {
                 "@annotation": {
-                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                     "properties": {
                         "belief": {
                             "$ref": "#/definitions/Belief",
@@ -498,10 +498,10 @@
             "type": "string"
         },
         "Edit": {
-            "description": "A set of edits transforms a version of a roll into another version. Edits insert or delete symbols, or both (= replace). Edits may be motivated by a given set of reasons, e.g. to add an additional accent or to correct an error. If an edit is the interpretation of a metamark, such as a pencil mark, this should be made explicit using a meaning comprehension on the `@annotation` field. An edit states no date. That it ended no later than the act that made a feature carrying a symbol it inserts, a reasoner derives with the axioms of reo.ttl; which of those dates bounds it closest is for a query to pick.",
+            "description": "A set of edits transforms a version of a roll into another version. Edits insert or delete symbols, or both (= replace). What kind of change an edit is follows from its motivation (`kindOfChange`). If an edit is the interpretation of a metamark, such as a pencil mark, this should be made explicit using a meaning comprehension on the `@annotation` field. An edit states no date. That it ended no later than the act that made a feature carrying a symbol it inserts, a reasoner derives with the axioms of reo.ttl; which of those dates bounds it closest is for a query to pick.",
             "properties": {
                 "@annotation": {
-                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                     "properties": {
                         "belief": {
                             "$ref": "#/definitions/Belief",
@@ -527,11 +527,6 @@
                     "type": "array",
                     "ontology": "reo:removed"
                 },
-                "editType": {
-                    "$ref": "#/definitions/EditType",
-                    "description": "The type of editorial change (e.g. 'correct-error', 'additional-accent').",
-                    "ontology": "crm:P2 has type"
-                },
                 "insert": {
                     "description": "The symbols to be inserted by this edit.",
                     "items": {
@@ -541,7 +536,7 @@
                     "ontology": "reo:added"
                 },
                 "motivation": {
-                    "description": "A textual description of the motivation for this edit, referencing a motivation defined in the version's motivations list.",
+                    "description": "Why the edit was made: one of the edition's motivations, by id, or one the vocabulary publishes, by IRI (`musicalChange`, `technicalChange`). An edit of a version that derives from none states none.",
                     "type": "string",
                     "ontology": "crm:P17 was motivated by"
                 },
@@ -563,20 +558,6 @@
             "type": "object",
             "ontology": "reo:Edit"
         },
-        "EditType": {
-            "description": "The type of editorial change applied to a symbol or set of symbols. Classifies the nature of the edit, e.g. whether it corrects an error, adds an accent, shifts a note, or shortens/prolongs a perforation.",
-            "enum": [
-                "additional-accent",
-                "add-redundancy",
-                "remove-redundancy",
-                "recoding",
-                "shift",
-                "correct-error",
-                "shorten",
-                "prolong"
-            ],
-            "type": "string"
-        },
         "Edition": {
             "description": "Describes the specific digital edition of a piano roll.",
             "properties": {
@@ -601,6 +582,13 @@
                     "type": "string",
                     "ontology": "dcterms:license"
                 },
+                "motivations": {
+                    "description": "The editor's motivations, each a reason for musical changes in words, stated once and named by the edits of any version (`Edit.motivation`). The motivations the vocabulary publishes are named by IRI and not stated here (`musicalChange`, `technicalChange`).",
+                    "items": {
+                        "$ref": "#/definitions/Motivation"
+                    },
+                    "type": "array"
+                },
                 "referenceCopy": {
                     "description": "The copy whose millimetres are the edition's axis, by id: every place the edition gives along the roll is a place on this copy's paper, counted from where its scan begins, and every other copy is aligned onto it. Choosing it is the one editorial decision the alignment leaves; a copy scanned whole and without tears serves best, since its places are what notes and readers cite. Left out, it is the first copy with features that is not aligned (`referenceCopyOf`).",
                     "type": "string",
@@ -648,7 +636,7 @@
             "ontology": "lrmoo:F2 Expression"
         },
         "EditionCreation": {
-            "description": "This type describes the creation of an edition, i.e. the editor, publisher, and publication date.",
+            "description": "This type describes the creation of an edition: the editors, publisher and publication date, the editorial principles the edition follows, and the programs it was made with.",
             "properties": {
                 "editors": {
                     "description": "The persons who prepared the edition, each with the part they took in the editorial work. An edition written before this field existed carries none.",
@@ -658,6 +646,14 @@
                     "type": "array",
                     "ontology": "crm:P14 carried out by"
                 },
+                "principles": {
+                    "description": "The editorial principles the edition follows, by IRI: the published rules its stemma and its edits rest on, whether the editor applied them or a program did, such as that the same addition at the same place is not made twice independently (`stemmaRules`, `editRules`). Adopting a proposal names those it follows. An edition that names none leaves it out.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array",
+                    "ontology": "crm:P33 used specific technique"
+                },
                 "publicationDate": {
                     "description": "The date on which the edition was published: where it states a version, the date of that version.",
                     "format": "date",
@@ -668,6 +664,14 @@
                     "$ref": "#/definitions/Person",
                     "description": "The person or institution responsible for publishing the edition.",
                     "ontology": "crm:P14 carried out by"
+                },
+                "software": {
+                    "description": "The programs the edition was made with, each with its release: the release of this library that found its stemma and grouped its edits, which finds them again with the defaults it has. Adopting a proposal names it, and saving the edition does not, so that the release named is the one that found what the edition states.",
+                    "items": {
+                        "$ref": "#/definitions/Software"
+                    },
+                    "type": "array",
+                    "ontology": "crm:P16 used specific object"
                 }
             },
             "required": [
@@ -1381,7 +1385,7 @@
             "type": "string"
         },
         "Motivation": {
-            "description": "A motivation provides a reason or rationale for an editorial change. Motivations are defined at the version level and referenced by edits.",
+            "description": "A reason for a musical change, in the editor's words. The edition states its motivations once (`Edition.motivations`), and an edit of any version names the one it was made for. Every change of a version that derives from another states a motivation: a program states whether it is musical or technical (`musicalChange`, `technicalChange`), and the editor puts a reason of their own in place of a musical one. Speculating about why a change was made is kept to the musical changes.",
             "properties": {
                 "note": {
                     "description": "A free-text note providing additional context.",
@@ -1710,7 +1714,7 @@
                 {
                     "properties": {
                         "@annotation": {
-                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                             "properties": {
                                 "belief": {
                                     "$ref": "#/definitions/Belief",
@@ -1748,7 +1752,7 @@
                 {
                     "properties": {
                         "@annotation": {
-                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                             "properties": {
                                 "belief": {
                                     "$ref": "#/definitions/Belief",
@@ -1796,7 +1800,7 @@
                 {
                     "properties": {
                         "@annotation": {
-                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                             "properties": {
                                 "belief": {
                                     "$ref": "#/definitions/Belief",
@@ -1864,7 +1868,7 @@
                 {
                     "properties": {
                         "@annotation": {
-                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                             "properties": {
                                 "belief": {
                                     "$ref": "#/definitions/Belief",
@@ -1903,7 +1907,7 @@
                 {
                     "properties": {
                         "@annotation": {
-                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                             "properties": {
                                 "belief": {
                                     "$ref": "#/definitions/Belief",
@@ -1946,7 +1950,7 @@
             "description": "An object assumption wraps a complex object with an optional annotation. Used for structured values (e.g. persons, conditions) whose properties may be uncertain.",
             "properties": {
                 "@annotation": {
-                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                     "properties": {
                         "belief": {
                             "$ref": "#/definitions/Belief",
@@ -1996,7 +2000,7 @@
             "description": "An object assumption wraps a complex object with an optional annotation. Used for structured values (e.g. persons, conditions) whose properties may be uncertain.",
             "properties": {
                 "@annotation": {
-                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                     "properties": {
                         "belief": {
                             "$ref": "#/definitions/Belief",
@@ -2050,7 +2054,7 @@
             "description": "An object assumption wraps a complex object with an optional annotation. Used for structured values (e.g. persons, conditions) whose properties may be uncertain.",
             "properties": {
                 "@annotation": {
-                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                     "properties": {
                         "belief": {
                             "$ref": "#/definitions/Belief",
@@ -2105,7 +2109,7 @@
             "description": "An object assumption wraps a complex object with an optional annotation. Used for structured values (e.g. persons, conditions) whose properties may be uncertain.",
             "properties": {
                 "@annotation": {
-                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                     "properties": {
                         "belief": {
                             "$ref": "#/definitions/Belief",
@@ -2151,7 +2155,7 @@
                 {
                     "properties": {
                         "@annotation": {
-                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                             "properties": {
                                 "belief": {
                                     "$ref": "#/definitions/Belief",
@@ -2198,7 +2202,7 @@
                 {
                     "properties": {
                         "@annotation": {
-                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                             "properties": {
                                 "belief": {
                                     "$ref": "#/definitions/Belief",
@@ -2250,7 +2254,7 @@
             "description": "An object assumption wraps a complex object with an optional annotation. Used for structured values (e.g. persons, conditions) whose properties may be uncertain.",
             "properties": {
                 "@annotation": {
-                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                     "properties": {
                         "belief": {
                             "$ref": "#/definitions/Belief",
@@ -2289,7 +2293,7 @@
             "description": "An object assumption wraps a complex object with an optional annotation. Used for structured values (e.g. persons, conditions) whose properties may be uncertain.",
             "properties": {
                 "@annotation": {
-                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                     "properties": {
                         "belief": {
                             "$ref": "#/definitions/Belief",
@@ -2331,7 +2335,7 @@
             "description": "An object assumption wraps a complex object with an optional annotation. Used for structured values (e.g. persons, conditions) whose properties may be uncertain.",
             "properties": {
                 "@annotation": {
-                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                     "properties": {
                         "belief": {
                             "$ref": "#/definitions/Belief",
@@ -2370,7 +2374,7 @@
             "description": "An object assumption wraps a complex object with an optional annotation. Used for structured values (e.g. persons, conditions) whose properties may be uncertain.",
             "properties": {
                 "@annotation": {
-                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                     "properties": {
                         "belief": {
                             "$ref": "#/definitions/Belief",
@@ -2409,7 +2413,7 @@
             "description": "An object assumption wraps a complex object with an optional annotation. Used for structured values (e.g. persons, conditions) whose properties may be uncertain.",
             "properties": {
                 "@annotation": {
-                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                     "properties": {
                         "belief": {
                             "$ref": "#/definitions/Belief",
@@ -2451,7 +2455,7 @@
             "description": "An object assumption wraps a complex object with an optional annotation. Used for structured values (e.g. persons, conditions) whose properties may be uncertain.",
             "properties": {
                 "@annotation": {
-                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                     "properties": {
                         "belief": {
                             "$ref": "#/definitions/Belief",
@@ -2483,7 +2487,7 @@
             "description": "An object assumption wraps a complex object with an optional annotation. Used for structured values (e.g. persons, conditions) whose properties may be uncertain.",
             "properties": {
                 "@annotation": {
-                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                     "properties": {
                         "belief": {
                             "$ref": "#/definitions/Belief",
@@ -2532,7 +2536,7 @@
             "description": "An object assumption wraps a complex object with an optional annotation. Used for structured values (e.g. persons, conditions) whose properties may be uncertain.",
             "properties": {
                 "@annotation": {
-                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                     "properties": {
                         "belief": {
                             "$ref": "#/definitions/Belief",
@@ -2569,7 +2573,7 @@
             "description": "An object assumption wraps a complex object with an optional annotation. Used for structured values (e.g. persons, conditions) whose properties may be uncertain.",
             "properties": {
                 "@annotation": {
-                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                     "properties": {
                         "belief": {
                             "$ref": "#/definitions/Belief",
@@ -2609,7 +2613,7 @@
             "description": "An object assumption wraps a complex object with an optional annotation. Used for structured values (e.g. persons, conditions) whose properties may be uncertain.",
             "properties": {
                 "@annotation": {
-                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                     "properties": {
                         "belief": {
                             "$ref": "#/definitions/Belief",
@@ -2650,7 +2654,7 @@
                 {
                     "properties": {
                         "@annotation": {
-                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                             "properties": {
                                 "belief": {
                                     "$ref": "#/definitions/Belief",
@@ -2689,7 +2693,7 @@
                 {
                     "properties": {
                         "@annotation": {
-                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                            "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                             "properties": {
                                 "belief": {
                                     "$ref": "#/definitions/Belief",
@@ -2732,7 +2736,7 @@
             "description": "An object assumption wraps a complex object with an optional annotation. Used for structured values (e.g. persons, conditions) whose properties may be uncertain.",
             "properties": {
                 "@annotation": {
-                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                     "properties": {
                         "belief": {
                             "$ref": "#/definitions/Belief",
@@ -2786,7 +2790,7 @@
             "description": "An object assumption wraps a complex object with an optional annotation. Used for structured values (e.g. persons, conditions) whose properties may be uncertain.",
             "properties": {
                 "@annotation": {
-                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                     "properties": {
                         "belief": {
                             "$ref": "#/definitions/Belief",
@@ -2832,7 +2836,7 @@
             "description": "An object assumption wraps a complex object with an optional annotation. Used for structured values (e.g. persons, conditions) whose properties may be uncertain.",
             "properties": {
                 "@annotation": {
-                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                     "properties": {
                         "belief": {
                             "$ref": "#/definitions/Belief",
@@ -3171,7 +3175,7 @@
             "description": "A reference assumption wraps a reference (by `@id`) with an optional annotation. Used when pointing to another entity whose association may be uncertain.",
             "properties": {
                 "@annotation": {
-                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.",
+                    "description": "An optional annotation expressing a belief about this assumption. Uses the JSON-LD-star `@annotation` mechanism to attach epistemic metadata (certainty and reasons) to any triple.\n\nA statement that carries none is stated plainly, and what a program concluded is stated so too: an edition asserts its stemma and its edits, as a printed edition does, and its creation names the principles and the release they were found by (`EditionCreation`). A belief is kept for what the editor doubts.",
                     "properties": {
                         "belief": {
                             "$ref": "#/definitions/Belief",
@@ -3386,7 +3390,7 @@
             "type": "object"
         },
         "Software": {
-            "description": "Software that captured a copy or measured it: the transcriber that read a recording into notes, the emulator that wrote a MIDI file, the program that found the holes on a scan or aligned two copies.",
+            "description": "Software that captured a copy or measured it: the transcriber that read a recording into notes, the emulator that wrote a MIDI file, the program that found the holes on a scan or aligned two copies. Or the software an edition was made with, such as the release of this library that found its stemma.",
             "properties": {
                 "name": {
                     "type": "string",
@@ -3604,13 +3608,6 @@
                     "type": "array",
                     "ontology": "reo:involvedEdit"
                 },
-                "motivations": {
-                    "description": "A collection of motivations used in this version's edits.",
-                    "items": {
-                        "$ref": "#/definitions/Motivation"
-                    },
-                    "type": "array"
-                },
                 "system": {
                     "$ref": "#/definitions/Concept",
                     "description": "The reproducing system this version is coded for. One roll was often issued for several of them, and a version is a reading in one system's words: its expression types are that system's vocabulary and its notes sit on that bar's positions. A system the type vocabulary knows carries the IRI of its concept as `id`, from which the export takes the system's own context.",
@@ -3623,7 +3620,6 @@
             },
             "required": [
                 "@id",
-                "motivations",
                 "system"
             ],
             "type": "object",

package/lib/software.d.ts

@@ -0,0 +1,12 @@
+/** This library, as an edition made with it names it. */
+import { Software } from "./model/Agent.js";
+/**
+ * This library, as the software an edition was made with: the release
+ * whose `proposeStemma` found the stemma and whose `proposeEdits`
+ * grouped the edits, which adopting them names in the edition's
+ * creation. The version is the release, which is raised together with
+ * package.json, and a test holds the two to each other, so that an
+ * edition names the release that finds again what it states.
+ * @category Reading and writing
+ */
+export declare const linkedRolls: Software;

package/lib/software.js

@@ -0,0 +1,10 @@
+/**
+ * This library, as the software an edition was made with: the release
+ * whose `proposeStemma` found the stemma and whose `proposeEdits`
+ * grouped the edits, which adopting them names in the edition's
+ * creation. The version is the release, which is raised together with
+ * package.json, and a test holds the two to each other, so that an
+ * edition names the release that finds again what it states.
+ * @category Reading and writing
+ */
+export const linkedRolls = { name: 'linked-rolls', version: '0.76.0' };

package/lib/spec/context.json

@@ -32,11 +32,6 @@
         "edit": {
             "@id": "reo:Edit",
             "@context": {
-                "editType": {
-                    "@id": "crm:P2_has_type",
-                    "@type": "@vocab",
-                    "@context": { "@vocab": "https://w3id.org/reo/type/" }
-                },
                 "motivation": {
                     "@id": "crm:P17_was_motivated_by",
                     "@type": "@id"
@@ -117,6 +112,14 @@
         },
         "editors": "crm:P14_carried_out_by",
         "publisher": "crm:P14_carried_out_by",
+        "principles": {
+            "@id": "crm:P33_used_specific_technique",
+            "@type": "@id"
+        },
+        "software": {
+            "@id": "crm:P16_used_specific_object",
+            "@context": { "version": "owl:versionInfo" }
+        },
         "publicationDate": {
             "@id": "dcterms:date",
             "@type": "xsd:date"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linked-rolls",
-  "version": "0.74.0",
+  "version": "0.76.0",
   "description": "Digital editions of piano rolls: import, collation, editorial assumptions, JSON-LD export, and emulation through a reproducing system",
   "license": "MIT",
   "repository": {