feat: update express changes with how to specify schemas

Author: ronaldtse

sources/express-changes/examples/arm.changes.yaml

@@ -1,6 +1,6 @@
 # yaml-language-server: $schema=https://www.expresslang.org/schemas/changes/v1/schema_changes.yaml
 ---
 schema: Document_and_version_identification_arm
-editions:
-- version: '2'
-- version: '3'
+versions:
+- version: 2
+- version: 3

sources/express-changes/examples/mapping.changes.yaml

@@ -1,17 +1,17 @@
 # yaml-language-server: $schema=https://www.expresslang.org/schemas/changes/v1/mapping_changes.yaml
 ---
 schema: dimension_tolerance
-editions:
-- version: '6'
+versions:
+- version: 6
   mappings:
   - description: Geometric_dimension entity and attributes mapping has been updated
   - description: Angle_plus_minus_bounds and Length_plus_minus_bounds mappings was
       added
-- version: '7'
+- version: 7
   mappings:
   - description: Angle_plus_minus_bounds mapping has been updated
   - description: Length_plus_minus_bounds mapping has been updated
   - description: Applied_activity_assignment ENTITY mapped
-- version: '8'
+- version: 8
   mappings:
   - description: Geometric_dimension entity and attributes mapping has been updated

sources/express-changes/examples/mim.changes.yaml

@@ -1,12 +1,12 @@
 # yaml-language-server: $schema=https://www.expresslang.org/schemas/changes/v1/schema_changes.yaml
 ---
 schema: Document_and_version_identification_mim
-editions:
-- version: '2'
+versions:
+- version: 2
   deletions:
   - type: USE_FROM
     name: Product_identification_mim
-- version: '3'
+- version: 3
   additions:
   - type: USE_FROM
     name: product_definition_schema

sources/express-changes/examples/support_resource_schema.changes.yaml

@@ -1,8 +1,8 @@
 # yaml-language-server: $schema=https://www.expresslang.org/schemas/changes/v1/schema_changes.yaml
 ---
 schema: support_resource_schema
-editions:
-- version: '2'
+versions:
+- version: 2
   description: |-
     The definitions of the following EXPRESS entity data types were modified:
 
@@ -15,7 +15,7 @@ editions:
   modifications:
   - type: FUNCTION
     name: bag_to_set
-- version: '4'
+- version: 4
   description: |-
     The following entity types had been introduced to support external element references outside the local population of entity instances:
 

sources/express-changes/schemas/schema_changes.yaml

@@ -41,9 +41,9 @@ definitions:
         description: Array of modified elements
         items:
           $ref: '#/definitions/item_change'
-      removals:
+      deletions:
         type: array
-        description: Array of removed elements
+        description: Array of deleted elements
         items:
           $ref: '#/definitions/item_change'
   item_change:

sources/express-changes/sections/aa-examples.adoc

@@ -3,7 +3,7 @@
 
 === General
 
-This annex provides example of the EXPRESS Changes YAML format.
+This annex provides examples of the EXPRESS Changes YAML format.
 
 === Schema change
 

sources/express-changes/sections/ab-schemas.adoc

@@ -3,32 +3,49 @@
 
 === General
 
-This annex provides the JSON Schema definitions for the EXPRESS Changes YAML
+This annex provides the YAML Schema definitions for the EXPRESS Changes YAML
 formats defined in this document.
 
 These schemas can be used to validate EXPRESS Changes YAML files and to
 generate documentation or tooling for working with EXPRESS change records.
 
+The schemas are defined in YAML Schema format that follows the JSON Schema
+format (draft-07).
+
+
 === Schema change schema
 
 The schema change schema defines the structure for recording modifications to
 EXPRESS schema structure across versions, as described in <<schema-change>>.
 
-The schema is defined in JSON Schema format (draft-07).
-
 [source,yaml]
 ----
 include::../schemas/schema_changes.yaml[]
 ----
 
+This schema can be used for validation by prefixing an EXPRESS Changes YAML
+file with the following comment line:
+
+[source,yaml]
+----
+# yaml-language-server: $schema=https://www.expresslang.org/schemas/changes/v1/schema_changes.yaml
+----
+
 === Mapping change schema
 
 The mapping change schema defines the structure for recording modifications to
 EXPRESS schema mappings across versions, as described in <<mapping-change>>.
 
-The schema is defined in JSON Schema format (draft-07).
-
 [source,yaml]
 ----
 include::../schemas/mapping_changes.yaml[]
 ----
+
+This schema can be used for validation by prefixing an EXPRESS Changes YAML
+file with the following comment line:
+
+[source,yaml]
+----
+# yaml-language-server: $schema=https://www.expresslang.org/schemas/changes/v1/mapping_changes.yaml
+----
+