Seed1

docs/errata.md

@@ -2,6 +2,32 @@
 
 This document lists errata for the YAML schema. This is used when older versions of the schema are incorrect, and a fix was made in later schema to correct the problem.
 
+## Release 27.0
+
+### mdm/commands/settings.yaml
+
+`DefaultApplications` - the setting is allowed on Shared iPad (user channel only), not forbidden.
+
+### mdm/profiles/com.apple.applicationaccess.new.yaml
+
+Replacements for keys deprecated in 10.15 were missing.
+
+### mdm/profiles/com.apple.dnsProxy.managed.yaml
+
+The `ProviderDesignatedRequirement` key in the `com.apple.dnsProxy.managed` profile payload was missing.
+
+### mdm/profiles/com.apple.loginwindow.yaml
+
+Several missing keys have been added.
+
+### mdm/profiles/com.apple.relay.managed.yaml
+
+`RelayUUID` is not available on macOS.
+
+### mdm/profiles/com.apple.webcontent-filter.yaml
+
+`FilterDataProviderBundleIdentifier` is available on iOS and visionOS.
+
 ## iOS 26.4
 
 ### other/skipkeys.yaml

docs/schema.md

@@ -15,6 +15,7 @@ The definition of the schema used here is in the `schema.yaml` file. That file c
 | responsekeys | array  | A list of YAML objects representing the command response |
 | reasons      | array  | A list of YAML objects representing declarative device management status reason codes |
 | notes        | array  | A list of YAML objects representing additional notes for the schema item as a whole |
+| examples     | array  | A list of references to example files for this schema object |
 
 ### Payload Object
 

docs/schema.yaml

@@ -387,3 +387,38 @@ properties:
         content:
           type: string
           description: The note content in "markdown" format.
+
+  examples:
+    type: object
+    description: An array of examples.
+    additionalProperties: false
+    required:
+    - title
+    - files
+    properties:
+      title:
+        type: string
+        description: Title for the example.
+      files:
+        type: array
+        description: An array of files with their own descriptions.
+        items:
+          type: object
+          description: A description and path for an example file.
+          additionalProperties: false
+          properties:
+            tab:
+              type: string
+              description: Tab title. Must be present when there are multiple items in files array. Must be unique.
+            description:
+              type: string
+              description: Description for the example. Must be present when there are multiple items in files array.
+            file:
+              type: string
+              description: The file path for the example data.
+            request-file:
+              type: string
+              description: The file path for the request example data in a tabbed request/response.
+            response-file:
+              type: string
+              description: The file path for the response example data in a tabbed request/response.