(PowerShellGH-642) Update reference docs for v3 schemas

This change updates the reference documentation to align
with the new schema URIs and the changes to the enumeration
and struct casing.

Author: michaeltlombardi

docs/reference/cli/config/get.md

@@ -1,6 +1,6 @@
 ---
 description: Command line reference for the 'dsc config get' command
-ms.date:     06/24/2024
+ms.date:     02/28/2025
 ms.topic:    reference
 title:       dsc config get
 ---
@@ -49,12 +49,12 @@ document saved as `example.dsc.config.yaml`.
 
 ```yaml
 # example.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
 - name: Windows only
   type: Microsoft.DSC/Assertion
   properties:
-    $schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+    $schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
     resources:
     - name: os
       type: Microsoft/OSInfo

docs/reference/cli/config/set.md

@@ -1,6 +1,6 @@
 ---
 description: Command line reference for the 'dsc config set' command
-ms.date:     06/24/2024
+ms.date:     02/28/2025
 ms.topic:    reference
 title:       dsc config set
 ---
@@ -50,12 +50,12 @@ The command inspects the resource instances defined in the configuration documen
 
 ```yaml
 # example.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
 - name: Windows only
   type: Microsoft.DSC/Assertion
   properties:
-    $schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+    $schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
     resources:
     - name: os
       type: Microsoft/OSInfo

docs/reference/cli/config/test.md

@@ -1,6 +1,6 @@
 ---
 description: Command line reference for the 'dsc config test' command
-ms.date:     06/24/2024
+ms.date:     02/28/2025
 ms.topic:    reference
 title:       dsc config test
 ---
@@ -49,12 +49,12 @@ resource instances defined in the configuration document saved as `example.dsc.c
 
 ```yaml
 # example.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
 - name: Windows only
   type: Microsoft.DSC/Assertion
   properties:
-    $schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+    $schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
     resources:
     - name: os
       type: Microsoft/OSInfo

docs/reference/cli/resource/list.md

@@ -1,6 +1,6 @@
 ---
 description: Command line reference for the 'dsc resource list' command
-ms.date:     06/24/2024
+ms.date:     02/28/2025
 ms.topic:    reference
 title:       dsc resource list
 ---
@@ -309,24 +309,24 @@ a summary table for the returned resources. The summary table includes the follo
 displayed in the listed order:
 
 - **Type** - The fully qualified type name of the resource.
-- **Kind** - Whether the resource is an `Adapter`, `Group`, or typical `Resource`. For more
-  information, see [DSC Resource kind schema reference][03].
+- **Kind** - Whether the resource is an `adapter`, `group`, `importer`, or typical `Resource`. For
+  more information, see [DSC Resource kind schema reference][03].
 - **Version** - The semantic version of the resource.
 - **Caps** - A display of the resource's [capabilities][04] as flags. The capabilities are
   displayed in the following order, using a `-` instead of the appropriate letter if the resource
   doesn't have a specific capability:
 
-  - `g` indicates that the resource has the [Get capability][05].
-  - `s` indicates that the resource has the [Set capability][06]
-  - `x` indicates that the resource has the [SetHandlesExist capability][07]
-  - `w` indicates that the resource has the [WhatIf capability][08]
-  - `t` indicates that the resource has the [Test capability][09]
-  - `d` indicates that the resource has the [Delete capability][10]
-  - `e` indicates that the resource has the [Export capability][11]
-  - `r` indicates that the resource has the [Resolve capability][12]
+  - `g` indicates that the resource has the [get capability][05].
+  - `s` indicates that the resource has the [set capability][06]
+  - `x` indicates that the resource has the [setHandlesExist capability][07]
+  - `w` indicates that the resource has the [whatIf capability][08]
+  - `t` indicates that the resource has the [test capability][09]
+  - `d` indicates that the resource has the [delete capability][10]
+  - `e` indicates that the resource has the [export capability][11]
+  - `r` indicates that the resource has the [resolve capability][12]
 
   For example, the `Microsoft.Windows/Registry` resource has the following capabilities: `gs--d-`,
-  indicating it has the `Get`, `Set`, and `Delete` capabilities.
+  indicating it has the `get`, `set`, and `delete` capabilities.
 - **RequireAdapter** - The fully qualified type name of the adapter resource that DSC uses to
   invoke the returned resource.
 - **Description** - The short description of the resource's purpose and usage.

docs/reference/cli/schema/command.md

@@ -1,6 +1,6 @@
 ---
 description: Command line reference for the 'dsc schema' command
-ms.date:     06/24/2024
+ms.date:     02/28/2025
 ms.topic:    reference
 title:       dsc schema
 ---
@@ -26,6 +26,22 @@ integrating tool.
 The application uses these schemas to validate data internally when it's received or represent the
 output for one of the application's commands.
 
+> [!NOTE]
+> Currently, the schemas returned by the `dsc schema` command and those published to GitHub are
+> not the same. The published schemas more fully describe and validate the data than the schemas
+> emitted by the command. The DSC team is working to canonicalize the schemas returned from the
+> command.
+>
+> Both the published schemas and those returned from this command correctly validate the data. The
+> schemas returned from this command are less strict than the published schemas. Even though data
+> validates against the schemas returned by this command, DSC may raise errors when processing the
+> data. For example, the returned schema for versions indicates that the valid value is a string -
+> but if you specify a string that isn't a semantic version, DSC raises an error. In that case, the
+> data passed the schema validation but was incorrect.
+>
+> Until the schemas are canonicalized, consider using the published schemas when indpendently
+> testing your configuration documents and resource manifests with a JSON Schema validation tool.
+
 ## Examples
 
 ### Example 1 - Retrieve the schema for the dsc resource get command result

docs/reference/schemas/config/functions/add.md

@@ -1,6 +1,6 @@
 ---
 description: Reference for the 'add' DSC configuration document function
-ms.date:     03/19/2024
+ms.date:     02/28/2025
 ms.topic:    reference
 title:       add
 ---
@@ -30,7 +30,7 @@ This example document shows how you can use the `add()` function to return the s
 
 ```yaml
 # add.example.1.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
 - name: Sum of 3 and 5
   type: Test/Echo
@@ -60,7 +60,7 @@ configuration functions that return integer values.
 
 ```yaml
 # add.example.2.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
 - name: Add nested function outputs
   type: Test/Echo

docs/reference/schemas/config/functions/base64.md

@@ -1,6 +1,6 @@
 ---
 description: Reference for the 'base64' DSC configuration document function
-ms.date:     01/17/2024
+ms.date:     02/28/2025
 ms.topic:    reference
 title:       base64
 ---
@@ -31,7 +31,7 @@ The configuration converts a basic string value with the `base64()` function.
 
 ```yaml
 # base64.example.1.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
   - name: Echo 'abc' in base64
     type: Test/Echo
@@ -61,7 +61,7 @@ strings `a`, `b`, and `c` into `abc` before returning the base64 representation.
 
 ```yaml
 # base64.example.2.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
   - name: Echo concatenated 'a', 'b', 'c' in base64
     type: Test/Echo

docs/reference/schemas/config/functions/concat.md

@@ -1,6 +1,6 @@
 ---
 description: Reference for the 'concat' DSC configuration document function
-ms.date:     01/17/2024
+ms.date:     02/28/2025
 ms.topic:    reference
 title:       concat
 ---
@@ -35,7 +35,7 @@ The configuration uses the `concat()` function to join the strings `abc` and `de
 
 ```yaml
 # concat.example.1.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
   - name: Echo 'abcdef'
     type: Test/Echo
@@ -64,7 +64,7 @@ The configuration uses the `concat()` function to return a combined array of str
 
 ```yaml
 # concat.example.2.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
 - name: Echo ['a', 'b', 'c', 'd', 'e', 'f']
   type: Test/Echo

docs/reference/schemas/config/functions/createArray.md

@@ -1,6 +1,6 @@
 ---
 description: Reference for the 'createArray' DSC configuration document function
-ms.date:     04/09/2024
+ms.date:     02/28/2025
 ms.topic:    reference
 title:       createArray
 ---
@@ -33,7 +33,7 @@ example synopsis
 
 ```yaml
 # createArray.example.1.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
 - name: Echo array of integers
   type: Test/Echo
@@ -66,7 +66,7 @@ sub-array contains only integers. The second sub-array contains only strings.
 
 ```yaml
 # createArray.example.2.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
 - name: Create array of arrays
   type: Test/Echo
@@ -102,7 +102,7 @@ strings. It uses YAML's folded multiline string syntax to make the function more
 
 ```yaml
 # createArray.example.3.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
 - name: Echo flattened array
   type: Test/Echo

docs/reference/schemas/config/functions/div.md

@@ -1,6 +1,6 @@
 ---
 description: Reference for the 'div' DSC configuration document function
-ms.date:     03/19/2024
+ms.date:     02/28/2025
 ms.topic:    reference
 title:       div
 ---
@@ -32,7 +32,7 @@ integers.
 
 ```yaml
 # div.example.1.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
 - name: Dividing integers
   type: Test/Echo
@@ -63,7 +63,7 @@ full integer value without the remainder. It doesn't round the result up to 3.
 
 ```yaml
 # div.example.2.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
 - name: Dividing nested functions
   type: Test/Echo

docs/reference/schemas/config/functions/envvar.md

@@ -1,6 +1,6 @@
 ---
 description: Reference for the 'envvar' DSC configuration document function
-ms.date:     03/01/2024
+ms.date:     02/28/2025
 ms.topic:    reference
 title:       envvar
 ---
@@ -35,7 +35,7 @@ This configuration echoes that folder with the `Test/Echo` resource.
 
 ```yaml
 # ./examples/envvar.example.1.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
   - name: Echo 'DSC_CONFIG_ROOT' in envvar
     type: Test/Echo

docs/reference/schemas/config/functions/int.md

@@ -1,6 +1,6 @@
 ---
 description: Reference for the 'int' DSC configuration document function
-ms.date:     06/13/2024
+ms.date:     02/28/2025
 ms.topic:    reference
 title:       int
 ---
@@ -31,7 +31,7 @@ This configuration returns an integer, converting the string value `'4.7'` to `4
 
 ```yaml
 # int.example.1.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
 - name: Echo integer value
   type: Test/Echo

docs/reference/schemas/config/functions/max.md

@@ -1,6 +1,6 @@
 ---
 description: Reference for the 'max' DSC configuration document function
-ms.date:     04/09/2024
+ms.date:     02/28/2025
 ms.topic:    reference
 title:       max
 ---
@@ -30,7 +30,7 @@ This configuration returns the largest number from a list of integers.
 
 ```yaml
 # max.example.1.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
 - name: Echo maximum value
   type: Test/Echo
@@ -61,7 +61,7 @@ function more readable.
 
 ```yaml
 # max.example.2.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
 - name: Echo integer array
   type: Test/Echo

docs/reference/schemas/config/functions/min.md

@@ -1,6 +1,6 @@
 ---
 description: Reference for the 'min' DSC configuration document function
-ms.date:     04/09/2024
+ms.date:     02/28/2025
 ms.topic:    reference
 title:       min
 ---
@@ -30,7 +30,7 @@ This configuration returns the smallest number from a list of integers.
 
 ```yaml
 # min.example.1.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
 - name: Echo minimum value
   type: Test/Echo
@@ -61,7 +61,7 @@ function more readable.
 
 ```yaml
 # min.example.2.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
 - name: Echo integer array
   type: Test/Echo

docs/reference/schemas/config/functions/mod.md

@@ -1,6 +1,6 @@
 ---
 description: Reference for the 'mod' DSC configuration document function
-ms.date:     03/19/2024
+ms.date:     02/28/2025
 ms.topic:    reference
 title:       mod
 ---
@@ -30,7 +30,7 @@ division for two integers.
 
 ```yaml
 # mod.example.1.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
 - name: Remainder for integers
   type: Test/Echo
@@ -60,7 +60,7 @@ two other mathematical operations.
 
 ```yaml
 # mod.example.2.dsc.config.yaml
-$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
+$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
 resources:
 - name: Remainder for nested functions
   type: Test/Echo