Setup repo

.openpublishing.publish.config.json

@@ -1,55 +1,57 @@
 {
+  "branch_target_mapping": {},
+  "branches_to_filter": [],
+  "contribution_branch_mappings": {},
+  "dependent_packages": [
+    {
+      "id": "Microsoft.DocAsCode.MAML2Yaml",
+      "nuget_feed": "https://www.myget.org/F/op/api/v2",
+      "path_to_root": "_dependentPackages/MAML2Yaml",
+      "target_framework": "net45",
+      "version": "latest"
+    }
+  ],
+  "dependent_repositories": [
+    {
+      "branch": "main",
+      "branch_mapping": {},
+      "path_to_root": "_themes",
+      "url": "https://github.com/Microsoft/templates.docs.msft"
+    }
+  ],
   "docsets_to_publish": [
     {
-      "docset_name": "PowerShell-Docs-DSC",
-      "build_source_folder": "dsc",
+      "base_path": "powershell",
+      "build_entry_point": "docs",
       "build_output_subfolder": "PowerShell-Docs-DSC",
+      "build_source_folder": "dsc",
+      "customized_tasks": {
+        "docset_prebuild": [
+          "_dependentPackages/MAML2Yaml/tools/Run.ps1"
+        ]
+      },
+      "docset_name": "PowerShell-Docs-DSC",
       "locale": "en-us",
-      "monikers": [],
       "moniker_ranges": [],
+      "monikers": [],
       "open_to_public_contributors": false,
+      "site_name": "Docs",
+      "template_folder": "_themes",
       "type_mapping": {
         "Conceptual": "Content",
+        "ManagedReference": "Content",
+        "PowershellCmdlet": "Content",
         "PowershellModule": "Content",
-        "PowershellCmdlet": "Content"
-      },
-      "build_entry_point": "docs",
-      "template_folder": "_themes",
-      "base_path": "powershell",
-      "site_name": "Docs",
-      "customized_tasks": {
-        "docset_prebuild": [
-          "_dependentPackages/MAML2Yaml/tools/Run.ps1"
-        ]
+        "RestApi": "Content"
       }
     }
   ],
-  "notification_subscribers": [],
-  "sync_notification_subscribers": [],
-  "branches_to_filter": [],
-  "skip_source_output_uploading": false,
-  "need_preview_pull_request": true,
-  "contribution_branch_mappings": {},
-  "dependent_repositories": [
-    {
-      "path_to_root": "_themes",
-      "url": "https://github.com/Microsoft/templates.docs.msft",
-      "branch": "main",
-      "branch_mapping": {}
-    }
-  ],
-  "branch_target_mapping": {},
-  "need_generate_pdf_url_template": false,
-  "dependent_packages": [
-    {
-      "id": "Microsoft.DocAsCode.MAML2Yaml",
-      "nuget_feed": "https://www.myget.org/F/op/api/v2",
-      "path_to_root": "_dependentPackages/MAML2Yaml",
-      "target_framework": "net45",
-      "version": "latest"
-    }
-  ],
   "monikerPath": [
     "mapping/monikerMapping.json"
-  ]
+  ],
+  "need_generate_pdf_url_template": false,
+  "need_preview_pull_request": true,
+  "notification_subscribers": [],
+  "skip_source_output_uploading": false,
+  "sync_notification_subscribers": []
 }

.openpublishing.redirection.json

@@ -0,0 +1,14 @@
+{
+    "redirections": [
+        {
+            "source_path": "dsc/dsc-2.0/docs-conceptual/index.md",
+            "redirect_url": "/powershell/dsc/overview",
+            "redirect_document_id": true
+        },
+        {
+            "source_path": "dsc/dsc-3.0/docs-conceptual/index.md",
+            "redirect_url": "/powershell/dsc/overview",
+            "redirect_document_id": true
+        }
+    ]
+}

dsc/breadcrumb/toc.yml

@@ -0,0 +1,17 @@
+- name: Docs
+  tocHref: /
+  topicHref: /
+  items:
+  - name: PowerShell
+    tocHref: /powershell/
+    topicHref: /powershell/index
+    items:
+  - name: PowerShell DSC
+    tocHref: /powershell/dsc/
+    topicHref: /powershell/dsc/overview
+  - name: PowerShell DSC
+    tocHref: /powershell/module/dsc-2.0
+    topicHref: /powershell/dsc/overview
+  - name: PowerShell DSC
+    tocHref: /powershell/module/dsc-3.0
+    topicHref: /powershell/dsc/overview

dsc/docfx.json

@@ -0,0 +1,60 @@
+{
+  "build": {
+    "content": [
+      { "dest": "dsc/breadcrumb", "files": [ "toc.yml" ], "src": "breadcrumb" },
+
+      { "dest": "dsc", "files": [ "**/*.md", "**/*.yml" ], "src": "docs-conceptual/dsc-2.0", "version": "dsc-2.0" },
+      { "dest": "module", "exclude": [ "toc.yml" ], "files": [ "**/*.yml" ], "src": "dsc-2.0", "version": "dsc-2.0" },
+      { "dest": "module/dsc-2.0", "files": [ "**/About/*.md", "**/*.yml" ], "src": "dsc-2.0", "version": "dsc-2.0" },
+
+      { "dest": "dsc", "files": [ "**/*.md", "**/*.yml" ], "src": "docs-conceptual/dsc-3.0", "version": "dsc-3.0" },
+      { "dest": "module", "exclude": [ "toc.yml" ], "files": [ "**/*.yml" ], "src": "dsc-3.0", "version": "dsc-3.0" },
+      { "dest": "module/dsc-3.0", "files": [ "**/About/*.md", "**/*.yml" ], "src": "dsc-3.0", "version": "dsc-3.0" },
+
+      { "dest": "dsc", "files": [ "**/*.md", "**/*.yml" ], "src": "virtual-folder" },
+      { "dest": "module", "files": [ "**/*.md", "**/*.yml" ], "src": "virtual-folder-module" }
+    ],
+    "exportRawModel": true,
+    "exportViewModel": true,
+    "externalReference": [],
+    "globalMetadata": {
+      "author": "sdwheeler",
+      "breadcrumb_path": "/powershell/dsc/breadcrumb/toc.json",
+      "extendBreadcrumb": true,
+      "feedback_system": "None",
+      "hideScope": false,
+      "ms.author": "sewhee",
+      "ms.devlang": "powershell",
+      "ms.prod": "powershell",
+      "ms.topic": "reference",
+      "searchScope": [
+        "PowerShell"
+      ],
+      "titleSuffix": "PowerShell",
+      "toc_preview": true,
+      "uhfHeaderId": "MSDocsHeader-Powershell"
+    },
+    "markdownEngineName": "markdig",
+    "overwrite": [],
+    "resource": [
+      {
+        "exclude": [
+          "**/obj/**",
+          "**/includes/**"
+        ],
+        "files": [
+          "**/media/**/*.png",
+          "**/media/**/*.gif",
+          "**/media/**/*.jpeg",
+          "**/media/**/*.jpg",
+          "**/media/**/*.svg"
+        ]
+      }
+    ],
+    "template": [],
+    "versions": {
+      "dsc-2.0": { "dest": "dsc-2.0" },
+      "dsc-3.0": { "dest": "dsc-3.0" }
+    }
+  }
+}

dsc/docs-conceptual/dsc-2.0/overview.md

@@ -0,0 +1,28 @@
+---
+description: Overview of the PSDesiredStateConfiguration v2.0.5 module.
+ms.date: 06/22/2021
+title:  PSDesiredStateConfiguration v2.0.5
+---
+# PSDesiredStateConfiguration v2.0.5
+
+DSC is an important platform in configuration management. With the release of PowerShell
+7.2-preview7, the PSDesiredStateConfiguration module is no longer be included in the PowerShell
+package. Separating DSC into its own module allows us to invest and develop DSC independent of
+PowerShell and reduces the size of the PowerShell package. Users of DSC will enjoy the benefit of
+upgrading DSC without the need to upgrade PowerShell, accelerating time to deployment of new DSC
+features. Users that want to continue using DSC v2 can download PSDesiredStateConfiguration 2.0.5
+from the PowerShell Gallery.
+
+Users working with non-Windows environments can expect cross-platform features in DSC v3. For more
+information about the future of DSC, see the
+[PowerShell Team blog](https://devblogs.microsoft.com/powershell/powershell-team-2021-investments/#dsc-for-powershell-7).
+
+To install PSDesiredStateConfiguration 2.0.5 from the PowerShell Gallery:
+
+```powershell
+Install-Module -Name PSDesiredStateConfiguration -Repository PSGallery -MaximumVersion 2.99
+```
+
+> [!IMPORTANT]
+> Be sure to include the parameter MaximumVersion or you could install version 3 (or higher) of
+> PSDesireStateConfiguration that contains significant differences.

dsc/docs-conceptual/dsc-2.0/toc.yml

@@ -0,0 +1,3 @@
+items:
+  - name: Overview
+    href: overview.md

dsc/docs-conceptual/dsc-3.0/overview.md

@@ -0,0 +1,28 @@
+---
+description: Overview of the PSDesiredStateConfiguration v3.0.0-beta1 module.
+ms.date: 06/22/2021
+title:  PSDesiredStateConfiguration v3.0.0-beta1
+---
+# PSDesiredStateConfiguration v3.0.0-beta1
+
+DSC is an important platform in configuration management. With the release of PowerShell
+7.2-preview7, the PSDesiredStateConfiguration module is no longer be included in the PowerShell
+package. Separating DSC into its own module allows us to invest and develop DSC independent of
+PowerShell and reduces the size of the PowerShell package. Users of DSC will enjoy the benefit of
+upgrading DSC without the need to upgrade PowerShell, accelerating time to deployment of new DSC
+features. Users that want to continue using DSC v2 can download PSDesiredStateConfiguration 2.0.5
+from the PowerShell Gallery.
+
+Users working with non-Windows environments can expect cross-platform features in DSC v3. For more
+information about the future of DSC, see the
+[PowerShell Team blog](https://devblogs.microsoft.com/powershell/powershell-team-2021-investments/#dsc-for-powershell-7).
+
+To install PSDesiredStateConfiguration 2.0.5 from the PowerShell Gallery:
+
+```powershell
+Install-Module -Name PSDesiredStateConfiguration -Repository PSGallery -MaximumVersion 2.99
+```
+
+> [!IMPORTANT]
+> Be sure to include the parameter MaximumVersion or you could install version 3 (or higher) of
+> PSDesireStateConfiguration that contains significant differences.

dsc/docs-conceptual/dsc-3.0/toc.yml

@@ -0,0 +1,3 @@
+items:
+  - name: Overview
+    href: overview.md