(GH-642) Generate schemas from source for v3.0

This change generates the canonical schemas for in new folders: `v3`,
`v3.0`, and `v3.0.0`, instead of the previous date-based folder
`2024/04`. The changing of the casing is _not_ backwards compatible, and
requires a new location to avoid breaking prior schemas.

This change generates the schemas into three folders to accomodate the
changes requested in #138 for moving from date-based to semantic
versioning for the schemas.

Going forward, schema generation should:

- Export to a folder for the current release with the full semantic
  version, like `v3.0.1` or `v3.1.0`.
- Export to a folder for the current `major.minor` schema, like `v3.0` or
  `v3.1`
- Build to a folder for the current major version of the release, like `v3`.

Under this design, you can:

- Get the exact version of the schema that a release shipped with by
  specifying the schema URI as `v<major>.<minor>.<patch>`
- Get the latest schema for your minor version as `v<major>.<minor>`
- Get the latest schema for your major version as `v<major>`

Breaking changes to the schema have the potential to break
integrating software, configuration documents, and resource manifests.
They therefore constitute a breaking change in the application and
require incrementing the major version segment of the semantic version.

This change will be followed by an update to the allowed schema versions
in the code itself, which should only recognize the updated schema at
this time, not previous schemas.

Author: michaeltlombardi

schemas/schemas.config.yaml

@@ -1,6 +1,6 @@
 host:             https://raw.githubusercontent.com
 prefix:           PowerShell/DSC/main/schemas
-version:          2024/04
+version:          v3.0
 docs_base_url:    https://learn.microsoft.com/powershell/dsc
 docs_version_pin: view=dsc-3.0&preserve-view=true
 bundle_schemas:

schemas/v3.0.0/bundled/config/document.json

@@ -0,0 +1,130 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.0.0/outputs/resource/get.json",
+  "title": "dsc resource get result",
+  "description": "Describes the return data for a DSC Resource instance from the `dsc resource get` command. The return data is either a single object that describes the actual state of a non-nested instance or an array of objects that describe the actual state of the nested instances for a group or adapter resource.",
+  "anyOf": [
+    {
+      "$ref": "/PowerShell/DSC/main/schemas/v3.0.0/outputs/resource/get.simple.json"
+    },
+    {
+      "type": "array",
+      "items": {
+        "$ref": "/PowerShell/DSC/main/schemas/v3.0.0/outputs/resource/get.full.json"
+      }
+    }
+  ],
+  "$defs": {
+    "https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.0.0/outputs/resource/get.simple.json": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.0.0/outputs/resource/get.simple.json",
+      "title": "dsc resource get result (simple)",
+      "description": "Describes the return data for a single DSC Resource instance from the `dsc resource get` command. This data is returned for instances that aren't group resources, adapter resources, or nested inside a group or adapter resource.\nWhen you use `dsc resource get` for a group or adapter resource, the command returns an array of full test result objects that include the name and type for the nested instances.",
+      "type": "object",
+      "required": [
+        "actualState"
+      ],
+      "properties": {
+        "actualState": {
+          "title": "Actual state",
+          "description": "This property always represents the current state of the DSC Resource instance as returned by its `get` method. DSC validates this return value against the DSC Resource's schema.",
+          "type": "object"
+        }
+      }
+    },
+    "https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.0.0/outputs/resource/get.full.json": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.0.0/outputs/resource/get.full.json",
+      "title": "dsc resource get result (full)",
+      "description": "Describes the return data for the full result of the `get` operation for a\nresource instance. This data is returned:\n\n- For every instance in a configuration document when you use the\n  `dsc config get` command.\n\n- For nested instances of a group or adapter resource when you use the\n  `dsc resource get` command.",
+      "type": "object",
+      "required": [
+        "metadata",
+        "name",
+        "result",
+        "type"
+      ],
+      "properties": {
+        "metadata": {
+          "$ref": "/PowerShell/DSC/main/schemas/v3.0.0/metadata/resourceInstanceResult.json"
+        },
+        "name": {
+          "$ref": "/PowerShell/DSC/main/schemas/v3.0.0/definitions/instanceName.json"
+        },
+        "type": {
+          "$ref": "/PowerShell/DSC/main/schemas/v3.0.0/definitions/resourceType.json"
+        },
+        "result": {
+          "$ref": "/PowerShell/DSC/main/schemas/v3.0.0/outputs/resource/get.json"
+        }
+      }
+    },
+    "https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.0.0/metadata/resourceInstanceResult.json": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.0.0/metadata/resourceInstanceResult.json",
+      "title": "Resource instance result metadata",
+      "description": "Defines metadata DSC returns for a DSC configuration operation against a resource instance in a configuration document, as from the `dsc config get` or `dsc config set` commands. The metadata properties under the `Microsoft.DSC` property describe the context of the operation.",
+      "type": "object",
+      "required": [
+        "Microsoft.DSC"
+      ],
+      "properties": {
+        "Microsoft.DSC": {
+          "title": "DSC context metadata",
+          "description": "The child properties for this metadata describe the context of the DSC operation against a resource instance, including the duration of the operation.",
+          "type": "object",
+          "required": [
+            "duration"
+          ],
+          "properties": {
+            "duration": {
+              "$ref": "/PowerShell/DSC/main/schemas/v3.0.0/metadata/Microsoft.DSC/duration.json"
+            }
+          }
+        }
+      }
+    },
+    "https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.0.0/definitions/instanceName.json": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.0.0/definitions/instanceName.json",
+      "title": "Instance name",
+      "description": "The short, human-readable name for a DSC Resource instance. Must be unique within a DSC Configuration document. Must be a non-empty string containing only letters, numbers, and spaces.",
+      "type": "string",
+      "pattern": "^[a-zA-Z0-9 ]+$",
+      "minLength": 1
+    },
+    "https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.0.0/definitions/resourceType.json": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.0.0/definitions/resourceType.json",
+      "title": "DSC Resource fully qualified type name",
+      "description": "The namespaced name of the DSC Resource, using the syntax:\n\nowner[.group][.area]/name\n\nFor example:\n\n  - Microsoft.SqlServer/Database\n  - Microsoft.SqlServer.Database/User\n",
+      "type": "string",
+      "pattern": "^\\w+(\\.\\w+){0,2}\\/\\w+$"
+    },
+    "https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.0.0/outputs/resource/get.json": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.0.0/outputs/resource/get.json",
+      "title": "dsc resource get result",
+      "description": "Describes the return data for a DSC Resource instance from the `dsc resource get` command. The return data is either a single object that describes the actual state of a non-nested instance or an array of objects that describe the actual state of the nested instances for a group or adapter resource.",
+      "anyOf": [
+        {
+          "$ref": "/PowerShell/DSC/main/schemas/v3.0.0/outputs/resource/get.simple.json"
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "/PowerShell/DSC/main/schemas/v3.0.0/outputs/resource/get.full.json"
+          }
+        }
+      ]
+    },
+    "https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.0.0/metadata/Microsoft.DSC/duration.json": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/v3.0.0/metadata/Microsoft.DSC/duration.json",
+      "title": "Duration",
+      "description": "Defines the duration of a DSC operation against a configuration document or resource instance as a string following the format defined in ISO8601 ABNF for `duration`. For example, `PT0.611216S` represents a duration of about `0.61` seconds. For more information, see: https://datatracker.ietf.org/doc/html/rfc3339#appendix-A",
+      "type": "string",
+      "format": "duration"
+    }
+  }
+}