better metadata

docs/features/instruction.md

@@ -2,19 +2,24 @@
 title: instruction
 ---
 
-**instruction, having to do with hierarchical paragraph numbers**
+**to change the set of actors**
 
 The so called instruction of a clause atom.
 
 This feature is present on objects of type [*clause_atom*](otype.md).
 
 The value is something like ``.q``, ``..``, ``.d``, ``ve``.
 
-##### See also
+A paragraph or subparagraph is started with the changing of the actual set of
+actors, through the introduction of an explicit NP-subject, typically
+by a WayX or WXQt clause.
 
-* [txt](txt.md)
+The instruction can:
+* Add an actor to the (empty) set
+* Reverse the roles in the set of actors: parallel connection
+* Suspend other actors in the set
 
 ##### Caution
-> I prefer a more informative definition.
-Explain why is this a useful feature? Examples needed.
+
+> More clarification needed as to what the values mean.
 

docs/features/nametype.md

@@ -18,3 +18,8 @@ code|description
 `topo`   |place
 `ppde`   |demonstrative personal pronoun
 
+##### Caution
+
+>
+It is unclear how completely and correctly this feature has been assigned.
+

docs/features/omap@ll.md

@@ -0,0 +1,20 @@
+---
+title: omap@ll
+---
+
+**node mapping**
+
+Maps all nodes of a previous version of the BHSA to the nodes of this version of the BHSA.
+
+The `ll` bit is in fact something like `2017-2021` in which case it is the mapping
+from version 2017 to 2021.
+
+Mappings are not perfect in general, because between versions words can have split or merged,
+and the same holds for phrases, clauses, sentences.
+
+De mapping does a fair job though, and it keeps the information about how good the correspondence
+is between a pair of nodes.
+
+For all the intricacies of node mapping, consult the notebook that created the mapping:
+
+[versionMappings.ipynb](https://nbviewer.org/github/ETCBC/bhsa/blob/master/programs/versionMappings.ipynb)

docs/features/pargr.md

@@ -10,12 +10,4 @@ This feature is present on objects of type [*clause_atom*](otype.md).
 
 The value is a hierarchical section number, like ``1`` or ``1.2`` or ``1.2.3.4``.
 
-A paragraph or subparagraph is started with the changing of the actual set of
-actors, through the introduction of an explicit NP-subject, typically
-by a WayX or WXQt clause.
-
-The introduction can:
-* Add an actor to the (empty) set
-* Reverse the roles in the set of actors: parallel connection
-* Suspend other actors in the set
 

docs/features/root.md

@@ -8,3 +8,12 @@ title: root
 > 
 This feature is present on objects of type [*word* and *lex*](otype.md).
 
+>
+This feature is experimental and incomplete
+(about 14% of the lexemes have this feature assigned).
+Hence, it is not present on all words.
+
+>
+Constantijn Sikkel has remarked
+"that the feature is not single-valued in principle; a lexeme can have zero, one, or more roots",
+but as far as I can see, there is never more than one root on a lexeme.