feat: update schema manifest doc with schemas

Author: ronaldtse

sources/express-schema-manifest/document.adoc

@@ -34,4 +34,8 @@ include::sections/03-terms.adoc[]
 
 include::sections/04-syntax.adoc[]
 
+include::sections/aa-examples.adoc[]
+
+include::sections/ab-schemas.adoc[]
+
 include::sections/99-bibliography.adoc[]

…/express-schema-manifest/schemas-srl.yml …chema-manifest/examples/schemas-srl.yamlsources/express-schema-manifest/schemas-srl.yml renamed to sources/express-schema-manifest/examples/schemas-srl.yaml sources/express-schema-manifest/schemas-srl.yml renamed to sources/express-schema-manifest/examples/schemas-srl.yaml

@@ -1,3 +1,4 @@
+# yaml-language-server: $schema=https://www.expresslang.org/schemas/manifest/v1/schema_manifest.yaml
 ---
 schemas:
   action_and_model_relationships_schema:

sources/express-schema-manifest/schemas/schema_manifest.yaml

@@ -0,0 +1,36 @@
+$schema: http://json-schema.org/draft-07/schema#
+title: EXPRESS Schema Manifest
+description: Defines a cohesive set of EXPRESS schemas and their locations.
+type: object
+required:
+  - schemas
+additionalProperties: false
+properties:
+  path:
+    type: string
+    description: >-
+      (optional) Root path for all schemas. If not set, the root path is set to
+      the directory where the manifest file is located. Can be an absolute path
+      or include shell expansions like ~ for home directory.
+  schemas:
+    type: object
+    description: >-
+      Map of schema names to their configurations. Each key is the name
+      of an EXPRESS schema.
+    additionalProperties:
+      oneOf:
+        - type: "null"
+          description: >-
+            Schema uses default path pattern: `{root_path}/{schema_name}.exp`.
+        - type: object
+          description: >-
+            Schema configuration with explicit path.
+          additionalProperties: false
+          properties:
+            path:
+              type: string
+              description: >-
+                Path to the schema file, relative to root path or absolute.
+                Relative paths that do not start with `/` are considered relative
+                to the root path. `..` can be used to refer to parent directories.
+                Can include shell expansions like `~`.

sources/express-schema-manifest/sections/04-syntax.adoc

@@ -1,3 +1,4 @@
+[[syntax]]
 == Syntax
 
 === General
@@ -28,7 +29,7 @@ schemas: <2>
   # ...
 ----
 <1> (optional) Root path
-<2> (mandatory)Schema listings
+<2> (mandatory) Schema listings
 <3> (mandatory) Individual EXPRESS schema names
 <4> (optional) Individual schema path
 

sources/express-schema-manifest/sections/aa-examples.adoc

@@ -0,0 +1,12 @@
+[appendix,obligation=informative]
+== Examples
+
+This annex provides examples of the EXPRESS Schema Manifest format.
+
+This example shows a schema manifest that defines a selection of schemas from
+the SRL (STEP Resource Library).
+
+[source,yaml]
+----
+include::../examples/schemas-srl.yaml[]
+----

sources/express-schema-manifest/sections/ab-schemas.adoc

@@ -0,0 +1,41 @@
+[appendix,obligation=normative]
+== Schemas
+
+=== General
+
+This annex provides the YAML Schema definitions for the EXPRESS Schema Manifest YAML
+format defined in this document.
+
+This schema can be used to validate EXPRESS Schema Manifest 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).
+
+The schema change schema defines the structure for recording modifications to
+EXPRESS schema structure across versions, as described in <<syntax>>.
+
+[source,yaml]
+----
+include::../schemas/schema_manifest.yaml[]
+----
+
+This schema can be used for validation by prefixing an EXPRESS Schema Manifest
+YAML file with the following comment line:
+
+[source,yaml]
+----
+# yaml-language-server: $schema=https://www.expresslang.org/schemas/manifest/v1/schema_manifest.yaml
+----
+
+[example]
+====
+[source,yaml]
+----
+# yaml-language-server: $schema=https://www.expresslang.org/schemas/manifest/v1/schema_manifest.yaml
+---
+schemas:
+  action_schema:
+    path: ./schemas/action_schema.exp
+----
+====