update gks-commons, jsons and rsts (#542)

schema/vrs/def/Adjacency.rst

@@ -19,23 +19,23 @@ Some Adjacency attributes are inherited from :ref:`Variation`.
    *  - id
       - string
       - 0..1
-      - The 'logical' identifier of the entity in the system of record, e.g. a UUID. This 'id' is unique within a given system. The identified entity may have a different 'id' in a different system, or may refer to an 'id' for the shared concept in another system (e.g. a CURIE).
+      - The 'logical' identifier of the Entity in the system of record, e.g. a UUID.  This 'id' is unique within a given system, but may or may not be globally unique outside the system. It is used within a system to reference an object from another.
    *  - label
       - string
       - 0..1
       - A primary name for the entity.
    *  - description
       - string
       - 0..1
-      - A free-text description of the entity.
+      - A free-text description of the Entity.
    *  - alternativeLabels
       - string
       - 0..m
       - Alternative name(s) for the Entity.
    *  - extensions
       - `Extension </ga4gh/schema/gks-common/1.x/data-types/json/Extension>`_
       - 0..m
-      - A list of extensions to the entity. Extensions are not expected to be natively understood, but may be used for pre-negotiated exchange of message attributes between systems.
+      - A list of extensions to the Entity, that allow for capture of information not directly supported by elements defined in the model.
    *  - digest
       - string
       - 0..1

schema/vrs/def/Allele.rst

@@ -19,23 +19,23 @@ Some Allele attributes are inherited from :ref:`Variation`.
    *  - id
       - string
       - 0..1
-      - The 'logical' identifier of the entity in the system of record, e.g. a UUID. This 'id' is unique within a given system. The identified entity may have a different 'id' in a different system, or may refer to an 'id' for the shared concept in another system (e.g. a CURIE).
+      - The 'logical' identifier of the Entity in the system of record, e.g. a UUID.  This 'id' is unique within a given system, but may or may not be globally unique outside the system. It is used within a system to reference an object from another.
    *  - label
       - string
       - 0..1
       - A primary name for the entity.
    *  - description
       - string
       - 0..1
-      - A free-text description of the entity.
+      - A free-text description of the Entity.
    *  - alternativeLabels
       - string
       - 0..m
       - Alternative name(s) for the Entity.
    *  - extensions
       - `Extension </ga4gh/schema/gks-common/1.x/data-types/json/Extension>`_
       - 0..m
-      - A list of extensions to the entity. Extensions are not expected to be natively understood, but may be used for pre-negotiated exchange of message attributes between systems.
+      - A list of extensions to the Entity, that allow for capture of information not directly supported by elements defined in the model.
    *  - digest
       - string
       - 0..1

schema/vrs/def/CisPhasedBlock.rst

@@ -19,23 +19,23 @@ Some CisPhasedBlock attributes are inherited from :ref:`Variation`.
    *  - id
       - string
       - 0..1
-      - The 'logical' identifier of the entity in the system of record, e.g. a UUID. This 'id' is unique within a given system. The identified entity may have a different 'id' in a different system, or may refer to an 'id' for the shared concept in another system (e.g. a CURIE).
+      - The 'logical' identifier of the Entity in the system of record, e.g. a UUID.  This 'id' is unique within a given system, but may or may not be globally unique outside the system. It is used within a system to reference an object from another.
    *  - label
       - string
       - 0..1
       - A primary name for the entity.
    *  - description
       - string
       - 0..1
-      - A free-text description of the entity.
+      - A free-text description of the Entity.
    *  - alternativeLabels
       - string
       - 0..m
       - Alternative name(s) for the Entity.
    *  - extensions
       - `Extension </ga4gh/schema/gks-common/1.x/data-types/json/Extension>`_
       - 0..m
-      - A list of extensions to the entity. Extensions are not expected to be natively understood, but may be used for pre-negotiated exchange of message attributes between systems.
+      - A list of extensions to the Entity, that allow for capture of information not directly supported by elements defined in the model.
    *  - digest
       - string
       - 0..1

schema/vrs/def/CopyNumber.rst

@@ -19,7 +19,7 @@ Some CopyNumber attributes are inherited from :ref:`Variation`.
    *  - id
       - string
       - 0..1
-      - The 'logical' identifier of the entity in the system of record, e.g. a UUID. This 'id' is unique within a given system. The identified entity may have a different 'id' in a different system, or may refer to an 'id' for the shared concept in another system (e.g. a CURIE).
+      - The 'logical' identifier of the Entity in the system of record, e.g. a UUID.  This 'id' is unique within a given system, but may or may not be globally unique outside the system. It is used within a system to reference an object from another.
    *  - type
       - string
       - 1..1
@@ -31,15 +31,15 @@ Some CopyNumber attributes are inherited from :ref:`Variation`.
    *  - description
       - string
       - 0..1
-      - A free-text description of the entity.
+      - A free-text description of the Entity.
    *  - alternativeLabels
       - string
       - 0..m
       - Alternative name(s) for the Entity.
    *  - extensions
       - `Extension </ga4gh/schema/gks-common/1.x/data-types/json/Extension>`_
       - 0..m
-      - A list of extensions to the entity. Extensions are not expected to be natively understood, but may be used for pre-negotiated exchange of message attributes between systems.
+      - A list of extensions to the Entity, that allow for capture of information not directly supported by elements defined in the model.
    *  - digest
       - string
       - 0..1

schema/vrs/def/CopyNumberChange.rst

@@ -19,23 +19,23 @@ Some CopyNumberChange attributes are inherited from :ref:`CopyNumber`.
    *  - id
       - string
       - 0..1
-      - The 'logical' identifier of the entity in the system of record, e.g. a UUID. This 'id' is unique within a given system. The identified entity may have a different 'id' in a different system, or may refer to an 'id' for the shared concept in another system (e.g. a CURIE).
+      - The 'logical' identifier of the Entity in the system of record, e.g. a UUID.  This 'id' is unique within a given system, but may or may not be globally unique outside the system. It is used within a system to reference an object from another.
    *  - label
       - string
       - 0..1
       - A primary name for the entity.
    *  - description
       - string
       - 0..1
-      - A free-text description of the entity.
+      - A free-text description of the Entity.
    *  - alternativeLabels
       - string
       - 0..m
       - Alternative name(s) for the Entity.
    *  - extensions
       - `Extension </ga4gh/schema/gks-common/1.x/data-types/json/Extension>`_
       - 0..m
-      - A list of extensions to the entity. Extensions are not expected to be natively understood, but may be used for pre-negotiated exchange of message attributes between systems.
+      - A list of extensions to the Entity, that allow for capture of information not directly supported by elements defined in the model.
    *  - digest
       - string
       - 0..1

schema/vrs/def/CopyNumberCount.rst

@@ -19,23 +19,23 @@ Some CopyNumberCount attributes are inherited from :ref:`CopyNumber`.
    *  - id
       - string
       - 0..1
-      - The 'logical' identifier of the entity in the system of record, e.g. a UUID. This 'id' is unique within a given system. The identified entity may have a different 'id' in a different system, or may refer to an 'id' for the shared concept in another system (e.g. a CURIE).
+      - The 'logical' identifier of the Entity in the system of record, e.g. a UUID.  This 'id' is unique within a given system, but may or may not be globally unique outside the system. It is used within a system to reference an object from another.
    *  - label
       - string
       - 0..1
       - A primary name for the entity.
    *  - description
       - string
       - 0..1
-      - A free-text description of the entity.
+      - A free-text description of the Entity.
    *  - alternativeLabels
       - string
       - 0..m
       - Alternative name(s) for the Entity.
    *  - extensions
       - `Extension </ga4gh/schema/gks-common/1.x/data-types/json/Extension>`_
       - 0..m
-      - A list of extensions to the entity. Extensions are not expected to be natively understood, but may be used for pre-negotiated exchange of message attributes between systems.
+      - A list of extensions to the Entity, that allow for capture of information not directly supported by elements defined in the model.
    *  - digest
       - string
       - 0..1

schema/vrs/def/DerivativeMolecule.rst

@@ -19,23 +19,23 @@ Some DerivativeMolecule attributes are inherited from :ref:`Variation`.
    *  - id
       - string
       - 0..1
-      - The 'logical' identifier of the entity in the system of record, e.g. a UUID. This 'id' is unique within a given system. The identified entity may have a different 'id' in a different system, or may refer to an 'id' for the shared concept in another system (e.g. a CURIE).
+      - The 'logical' identifier of the Entity in the system of record, e.g. a UUID.  This 'id' is unique within a given system, but may or may not be globally unique outside the system. It is used within a system to reference an object from another.
    *  - label
       - string
       - 0..1
       - A primary name for the entity.
    *  - description
       - string
       - 0..1
-      - A free-text description of the entity.
+      - A free-text description of the Entity.
    *  - alternativeLabels
       - string
       - 0..m
       - Alternative name(s) for the Entity.
    *  - extensions
       - `Extension </ga4gh/schema/gks-common/1.x/data-types/json/Extension>`_
       - 0..m
-      - A list of extensions to the entity. Extensions are not expected to be natively understood, but may be used for pre-negotiated exchange of message attributes between systems.
+      - A list of extensions to the Entity, that allow for capture of information not directly supported by elements defined in the model.
    *  - digest
       - string
       - 0..1

schema/vrs/def/Ga4ghIdentifiableObject.rst

@@ -19,7 +19,7 @@ Some Ga4ghIdentifiableObject attributes are inherited from :ref:`gks.core-im:Ent
    *  - id
       - string
       - 0..1
-      - The 'logical' identifier of the entity in the system of record, e.g. a UUID. This 'id' is unique within a given system. The identified entity may have a different 'id' in a different system, or may refer to an 'id' for the shared concept in another system (e.g. a CURIE).
+      - The 'logical' identifier of the Entity in the system of record, e.g. a UUID.  This 'id' is unique within a given system, but may or may not be globally unique outside the system. It is used within a system to reference an object from another.
    *  - type
       - string
       - 1..1
@@ -31,15 +31,15 @@ Some Ga4ghIdentifiableObject attributes are inherited from :ref:`gks.core-im:Ent
    *  - description
       - string
       - 0..1
-      - A free-text description of the entity.
+      - A free-text description of the Entity.
    *  - alternativeLabels
       - string
       - 0..m
       - Alternative name(s) for the Entity.
    *  - extensions
       - `Extension </ga4gh/schema/gks-common/1.x/data-types/json/Extension>`_
       - 0..m
-      - A list of extensions to the entity. Extensions are not expected to be natively understood, but may be used for pre-negotiated exchange of message attributes between systems.
+      - A list of extensions to the Entity, that allow for capture of information not directly supported by elements defined in the model.
    *  - digest
       - string
       - 0..1

schema/vrs/def/LengthExpression.rst

@@ -19,23 +19,23 @@ Some LengthExpression attributes are inherited from :ref:`SequenceExpression`.
    *  - id
       - string
       - 0..1
-      - The 'logical' identifier of the entity in the system of record, e.g. a UUID. This 'id' is unique within a given system. The identified entity may have a different 'id' in a different system, or may refer to an 'id' for the shared concept in another system (e.g. a CURIE).
+      - The 'logical' identifier of the Entity in the system of record, e.g. a UUID.  This 'id' is unique within a given system, but may or may not be globally unique outside the system. It is used within a system to reference an object from another.
    *  - label
       - string
       - 0..1
       - A primary name for the entity.
    *  - description
       - string
       - 0..1
-      - A free-text description of the entity.
+      - A free-text description of the Entity.
    *  - alternativeLabels
       - string
       - 0..m
       - Alternative name(s) for the Entity.
    *  - extensions
       - `Extension </ga4gh/schema/gks-common/1.x/data-types/json/Extension>`_
       - 0..m
-      - A list of extensions to the entity. Extensions are not expected to be natively understood, but may be used for pre-negotiated exchange of message attributes between systems.
+      - A list of extensions to the Entity, that allow for capture of information not directly supported by elements defined in the model.
    *  - type
       - string
       - 1..1

schema/vrs/def/LiteralSequenceExpression.rst

@@ -19,23 +19,23 @@ Some LiteralSequenceExpression attributes are inherited from :ref:`SequenceExpre
    *  - id
       - string
       - 0..1
-      - The 'logical' identifier of the entity in the system of record, e.g. a UUID. This 'id' is unique within a given system. The identified entity may have a different 'id' in a different system, or may refer to an 'id' for the shared concept in another system (e.g. a CURIE).
+      - The 'logical' identifier of the Entity in the system of record, e.g. a UUID.  This 'id' is unique within a given system, but may or may not be globally unique outside the system. It is used within a system to reference an object from another.
    *  - label
       - string
       - 0..1
       - A primary name for the entity.
    *  - description
       - string
       - 0..1
-      - A free-text description of the entity.
+      - A free-text description of the Entity.
    *  - alternativeLabels
       - string
       - 0..m
       - Alternative name(s) for the Entity.
    *  - extensions
       - `Extension </ga4gh/schema/gks-common/1.x/data-types/json/Extension>`_
       - 0..m
-      - A list of extensions to the entity. Extensions are not expected to be natively understood, but may be used for pre-negotiated exchange of message attributes between systems.
+      - A list of extensions to the Entity, that allow for capture of information not directly supported by elements defined in the model.
    *  - type
       - string
       - 1..1

schema/vrs/def/ReferenceLengthExpression.rst

@@ -19,23 +19,23 @@ Some ReferenceLengthExpression attributes are inherited from :ref:`SequenceExpre
    *  - id
       - string
       - 0..1
-      - The 'logical' identifier of the entity in the system of record, e.g. a UUID. This 'id' is unique within a given system. The identified entity may have a different 'id' in a different system, or may refer to an 'id' for the shared concept in another system (e.g. a CURIE).
+      - The 'logical' identifier of the Entity in the system of record, e.g. a UUID.  This 'id' is unique within a given system, but may or may not be globally unique outside the system. It is used within a system to reference an object from another.
    *  - label
       - string
       - 0..1
       - A primary name for the entity.
    *  - description
       - string
       - 0..1
-      - A free-text description of the entity.
+      - A free-text description of the Entity.
    *  - alternativeLabels
       - string
       - 0..m
       - Alternative name(s) for the Entity.
    *  - extensions
       - `Extension </ga4gh/schema/gks-common/1.x/data-types/json/Extension>`_
       - 0..m
-      - A list of extensions to the entity. Extensions are not expected to be natively understood, but may be used for pre-negotiated exchange of message attributes between systems.
+      - A list of extensions to the Entity, that allow for capture of information not directly supported by elements defined in the model.
    *  - type
       - string
       - 1..1

schema/vrs/def/SequenceExpression.rst

@@ -19,23 +19,23 @@ Some SequenceExpression attributes are inherited from :ref:`gks.core-im:Entity`.
    *  - id
       - string
       - 0..1
-      - The 'logical' identifier of the entity in the system of record, e.g. a UUID. This 'id' is unique within a given system. The identified entity may have a different 'id' in a different system, or may refer to an 'id' for the shared concept in another system (e.g. a CURIE).
+      - The 'logical' identifier of the Entity in the system of record, e.g. a UUID.  This 'id' is unique within a given system, but may or may not be globally unique outside the system. It is used within a system to reference an object from another.
    *  - label
       - string
       - 0..1
       - A primary name for the entity.
    *  - description
       - string
       - 0..1
-      - A free-text description of the entity.
+      - A free-text description of the Entity.
    *  - alternativeLabels
       - string
       - 0..m
       - Alternative name(s) for the Entity.
    *  - extensions
       - `Extension </ga4gh/schema/gks-common/1.x/data-types/json/Extension>`_
       - 0..m
-      - A list of extensions to the entity. Extensions are not expected to be natively understood, but may be used for pre-negotiated exchange of message attributes between systems.
+      - A list of extensions to the Entity, that allow for capture of information not directly supported by elements defined in the model.
    *  - type
       - string
       - 1..1

schema/vrs/def/SequenceLocation.rst

@@ -19,23 +19,23 @@ Some SequenceLocation attributes are inherited from :ref:`Ga4ghIdentifiableObjec
    *  - id
       - string
       - 0..1
-      - The 'logical' identifier of the entity in the system of record, e.g. a UUID. This 'id' is unique within a given system. The identified entity may have a different 'id' in a different system, or may refer to an 'id' for the shared concept in another system (e.g. a CURIE).
+      - The 'logical' identifier of the Entity in the system of record, e.g. a UUID.  This 'id' is unique within a given system, but may or may not be globally unique outside the system. It is used within a system to reference an object from another.
    *  - label
       - string
       - 0..1
       - A primary name for the entity.
    *  - description
       - string
       - 0..1
-      - A free-text description of the entity.
+      - A free-text description of the Entity.
    *  - alternativeLabels
       - string
       - 0..m
       - Alternative name(s) for the Entity.
    *  - extensions
       - `Extension </ga4gh/schema/gks-common/1.x/data-types/json/Extension>`_
       - 0..m
-      - A list of extensions to the entity. Extensions are not expected to be natively understood, but may be used for pre-negotiated exchange of message attributes between systems.
+      - A list of extensions to the Entity, that allow for capture of information not directly supported by elements defined in the model.
    *  - digest
       - string
       - 0..1