feat: update changes yaml spec for latest ISO 10303

.gitignore

@@ -0,0 +1,7 @@
+*.abort
+Gemfile.lock
+*.log.*
+*.err
+relaton/
+iev/
+_site/

sources/express-changes/document.adoc

@@ -2,7 +2,7 @@
 :docnumber: 5005
 :edition: 1
 :copyright-year: 2025
-:revdate: 2025-02-06
+:revdate: 2025-10-14
 :language: en
 :title-main-en: EXPRESS changes model in YAML
 :doctype: standard
@@ -32,6 +32,12 @@ include::sections/02-normrefs.adoc[]
 
 include::sections/03-terms.adoc[]
 
-include::sections/04-spec.adoc[]
+include::sections/04-structure.adoc[]
+
+include::sections/05-schema-change.adoc[]
+
+include::sections/06-mapping-change.adoc[]
+
+include::sections/aa-examples.adoc[]
 
 include::sections/az-bibliography.adoc[]

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/04-structure.adoc

@@ -0,0 +1,40 @@
+== Structure
+
+An EXPRESS Changes document is a YAML file that records changes made to an
+EXPRESS schema across different editions or versions.
+
+There are two kinds of changes:
+
+* Schema changes
+* Mapping changes
+
+The top-level structure of an EXPRESS Changes document has the following
+specification.
+
+[source,yaml]
+----
+schema: String (required)
+  # Name of the EXPRESS schema
+editions:
+  - version: String (required)
+    # Version number for this change edition
+    description: String (optional)
+    # Description of changes in this edition
+    {type_of_change}:
+      - description: String (required)
+        # Description of the change
+        # ... additional fields depending on type_of_change
+----
+
+Fields:
+
+`schema`:: The name of the EXPRESS schema (string) (required).
++
+[example]
+`support_resource_schema`
+
+`editions`:: An array of edition change objects (required).
+
+`type_of_change`:: One of `additions`, `modifications`, `removals`, or
+`mapping`.
+