(ADO-500444) Deprecate PSDSC for Linux (#380)

* (ADO-500444) Deprecate PSDSC for Linux

PowerShell DSC for Linux is no longer supported. This change:

- Removes the content for Linux resources and getting started with PSDSC
  on Linux.
- Adds a new file clarifying the deprecation and end of support, and
  directs users to DSC and Azure machine configuration for continued use
  of PSDSC resources on Linux.
- Redirects the removed articles to the deprecation article.
- Sets the freshness cycle for PSDSC v1.1 and v2.0 content to 10 years.
- Updates the TOC for the v1.1 content to reflect the changes.
- Fixes AB#500444

* Fix build warnings

---------

Co-authored-by: Sean Wheeler <[email protected]>

Author: michaeltlombardi

.openpublishing.redirection.json

@@ -35,6 +35,61 @@
             "redirect_url": "/powershell/dsc/overview",
             "redirect_document_id": false
         },
+        {
+            "source_path": "dsc/docs-conceptual/dsc-1.1/getting-started/lnxGettingStarted.md",
+            "redirect_url": "/powershell/dsc/reference/resources/linux",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "dsc/docs-conceptual/dsc-1.1/reference/resources/linux/lnxArchiveResource.md",
+            "redirect_url": "/powershell/dsc/reference/resources/linux",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "dsc/docs-conceptual/dsc-1.1/reference/resources/linux/lnxEnvironmentResource.md",
+            "redirect_url": "/powershell/dsc/reference/resources/linux",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "dsc/docs-conceptual/dsc-1.1/reference/resources/linux/lnxFileLineResource.md",
+            "redirect_url": "/powershell/dsc/reference/resources/linux",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "dsc/docs-conceptual/dsc-1.1/reference/resources/linux/lnxFileResource.md",
+            "redirect_url": "/powershell/dsc/reference/resources/linux",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "dsc/docs-conceptual/dsc-1.1/reference/resources/linux/lnxGroupResource.md",
+            "redirect_url": "/powershell/dsc/reference/resources/linux",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "dsc/docs-conceptual/dsc-1.1/reference/resources/linux/lnxPackageResource.md",
+            "redirect_url": "/powershell/dsc/reference/resources/linux",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "dsc/docs-conceptual/dsc-1.1/reference/resources/linux/lnxScriptResource.md",
+            "redirect_url": "/powershell/dsc/reference/resources/linux",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "dsc/docs-conceptual/dsc-1.1/reference/resources/linux/lnxServiceResource.md",
+            "redirect_url": "/powershell/dsc/reference/resources/linux",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "dsc/docs-conceptual/dsc-1.1/reference/resources/linux/lnxSshAuthorizedKeysResource.md",
+            "redirect_url": "/powershell/dsc/reference/resources/linux",
+            "redirect_document_id": false
+        },
+        {
+            "source_path": "dsc/docs-conceptual/dsc-1.1/reference/resources/linux/lnxUserResource.md",
+            "redirect_url": "/powershell/dsc/reference/resources/linux",
+            "redirect_document_id": false
+        },
         {
             "source_path": "dsc/docs-conceptual/dsc-2.0/concepts/terminology.md",
             "redirect_url": "/powershell/dsc/concepts/glossary?view=dsc-2.0",

dsc/docfx.json

@@ -45,7 +45,7 @@
         "dsc-3.0/**/*.yml": "cmdlets"
       },
       "ms.topic": {
-        "docs-conceptual/**": "conceptual",
+        "docs-conceptual/**": "concept-article",
         "docs-conceptual/**/getting-started/**": "get-started",
         "docs-conceptual/**/get-started/**": "get-started",
         "docs-conceptual/**/how-tos/**": "how-to",
@@ -55,11 +55,15 @@
         "docs-conceptual/**/troubleshooting/**": "troubleshooting",
         "docs-conceptual/**/tutorials/**": "tutorial",
         "dsc-1.1/PSDesiredStateConfiguration/*": "reference",
-        "dsc-1.1/PSDesiredStateConfiguration/About/*.md": "conceptual",
+        "dsc-1.1/PSDesiredStateConfiguration/About/*.md": "concept-article",
         "dsc-2.0/PSDesiredStateConfiguration/*": "reference",
-        "dsc-2.0/PSDesiredStateConfiguration/About/*.md": "conceptual",
+        "dsc-2.0/PSDesiredStateConfiguration/About/*.md": "concept-article",
         "dsc-3.0/PSDesiredStateConfiguration/*": "reference",
-        "dsc-3.0/PSDesiredStateConfiguration/About/*.md": "conceptual"
+        "dsc-3.0/PSDesiredStateConfiguration/About/*.md": "concept-article"
+      },
+      "ms.update-cycle": {
+        "dsc-1.1/**": "3650-days",
+        "dsc-2.0/**": "1825-days"
       }
     },
     "globalMetadata": {

dsc/docs-conceptual/dsc-1.1/getting-started/lnxGettingStarted.md

@@ -0,0 +1,29 @@
+---
+ms.date: 10/23/2025
+ms.topic: reference
+title: DSC for Linux Resources
+description: DSC for Linux Resources
+---
+
+# DSC for Linux Resources
+
+DSC for Linux is no longer supported. The [PowerShell DSC for Linux project][01] was deprecated and
+archived on 12 September 2024. On 30 September 2023, Microsoft retired the desired state
+configuration (DSC) extension for Linux virtual machines and support for Linux machines in Azure
+Automation DSC. The [OMI project][02] has been deprecated since 24 March 2025.
+
+You can continue to use PowerShell DSC resources on Linux through the following tools:
+
+- [Azure machine configuration][03]
+- [Microsoft desired state configuration][04]
+
+You can continue to use updated versions of the resources previously provided by PowerShell DSC for
+Linux with the [nxtools module][05], which is [available on the PowerShell Gallery][06].
+
+<!-- Link reference definitions -->
+[01]: https://github.com/microsoft/PowerShell-DSC-for-Linux
+[02]: https://github.com/microsoft/omi
+[03]: /azure/governance/machine-configuration/overview
+[04]: ../../../overview.md?view=dsc-3.0&preserve-view=true
+[05]: https://github.com/azure/nxtools
+[06]: https://www.powershellgallery.com/packages/nxtools/1.6.0