feat: add YAML schemas for schema changes and mapping changes

Author: ronaldtse

sources/express-changes/schemas/mapping_changes.yaml

@@ -0,0 +1,47 @@
+$schema: http://json-schema.org/draft-07/schema#
+title: EXPRESS Mapping Changes
+description: Records modifications to EXPRESS schema mappings across editions
+type: object
+required:
+  - schema
+  - editions
+properties:
+  schema:
+    type: string
+    description: Name of the EXPRESS schema
+  editions:
+    type: array
+    description: Array of edition changes
+    items:
+      $ref: '#/definitions/edition_change'
+definitions:
+  edition_change:
+    type: object
+    description: Changes made to the mapping specification in a specific edition
+    required:
+      - version
+    properties:
+      version:
+        type: string
+        description: Version number for this change edition
+        pattern: '^[1-9][0-9]*$'
+      description:
+        type: string
+        description: >-
+          Multi-line string describing the changes made in this edition.
+          Provides comprehensive overview of what changed and why.
+      mappings:
+        type: array
+        description: Array of mapping changes
+        items:
+          $ref: '#/definitions/mapping_change'
+  mapping_change:
+    type: object
+    description: Represents a specific element whose mapping has changed
+    properties:
+      name:
+        type: string
+        description: Name of the EXPRESS construct whose mapping changed
+      description:
+        type: string
+        description: Description of the mapping change

sources/express-changes/schemas/schema_changes.yaml

@@ -0,0 +1,83 @@
+$schema: http://json-schema.org/draft-07/schema#
+title: EXPRESS Schema Changes
+description: Records modifications to EXPRESS schema structure across editions
+type: object
+required:
+  - schema
+  - editions
+properties:
+  schema:
+    type: string
+    description: Name of the EXPRESS schema
+  editions:
+    type: array
+    description: Array of edition changes
+    items:
+      $ref: '#/definitions/edition_change'
+definitions:
+  edition_change:
+    type: object
+    description: Changes made to the schema in a specific edition
+    required:
+      - version
+    properties:
+      version:
+        type: string
+        description: Version number for this change edition
+        pattern: '^[1-9][0-9]*$'
+      description:
+        type: string
+        description: >-
+          Multi-line string describing the changes made in this edition.
+          Provides comprehensive overview of what changed and why.
+      additions:
+        type: array
+        description: Array of added elements
+        items:
+          $ref: '#/definitions/item_change'
+      modifications:
+        type: array
+        description: Array of modified elements
+        items:
+          $ref: '#/definitions/item_change'
+      removals:
+        type: array
+        description: Array of removed elements
+        items:
+          $ref: '#/definitions/item_change'
+  item_change:
+    type: object
+    description: Represents a specific schema element change
+    required:
+      - type
+      - name
+    properties:
+      type:
+        type: string
+        description: Type of the EXPRESS construct
+        enum:
+          - ENTITY
+          - TYPE
+          - FUNCTION
+          - RULE
+          - PROCEDURE
+          - CONSTANT
+          - REFERENCE_FROM
+          - USE_FROM
+      name:
+        type: string
+        description: Name of the EXPRESS construct
+      description:
+        type: array
+        description: >-
+          Array of strings describing the change. Each string represents
+          a description for a single change in the named target.
+        items:
+          type: string
+      interfaced_items:
+        type: array
+        description: >-
+          For USE_FROM or REFERENCE_FROM, list of specific items referenced
+          or used. Not needed when in deletions.
+        items:
+          type: string

sources/express-changes/sections/05-schema-change.adoc

@@ -1,4 +1,5 @@
 
+[[schema-change]]
 == Schema change
 
 === General

sources/express-changes/sections/06-mapping-change.adoc

@@ -1,3 +1,4 @@
+[[mapping-change]]
 == Mapping change
 
 === General
@@ -94,4 +95,3 @@ editions:
   description: Mapping specifications updated.
 ----
 ====
-

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

@@ -0,0 +1,34 @@
+[appendix,obligation=informative]
+== Schemas
+
+=== General
+
+This annex provides the JSON 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.
+
+=== Schema change schema
+
+The schema change schema defines the structure for recording modifications to
+EXPRESS schema structure across editions, as described in <<schema-change>>.
+
+The schema is defined in JSON Schema format (draft-07).
+
+[source,yaml]
+----
+include::../schemas/schema_changes.yaml[]
+----
+
+=== Mapping change schema
+
+The mapping change schema defines the structure for recording modifications to
+EXPRESS schema mappings across editions, as described in <<mapping-change>>.
+
+The schema is defined in JSON Schema format (draft-07).
+
+[source,yaml]
+----
+include::../schemas/mapping_changes.yaml[]
+----