3/19/2025 PM Publish

reference/docs-conceptual/dsc/overview.md

@@ -1,34 +1,36 @@
 ---
-description: DSC is a management platform in PowerShell that enables you to manage your IT and development infrastructure with configuration as code.
-ms.date: 02/02/2023
-title: PowerShell Desired State Configuration (DSC)
+description: DSC is a management platform that enables you to manage your IT and development infrastructure with configuration as code.
+ms.date: 03/18/2025
+title: Desired State Configuration (DSC)
 ---
 
-# PowerShell Desired State Configuration (DSC) Overview
+# Desired State Configuration (DSC) Overview
 
-DSC is a management platform in PowerShell that enables you to manage your IT and development
-infrastructure with configuration as code.
+DSC is a management platform that enables you to manage your IT and development infrastructure with
+configuration as code.
 
-There are three versions of DSC available:
+There are four versions of DSC available:
 
-- DSC 1.1 is the legacy version of DSC that originally shipped in Windows PowerShell 5.1.
-- DSC 2.0 is the version of DSC that shipped in PowerShell 7.
+- **Microsoft DSC 3.0** is the new version of DSC. This version provides true cross-platform
+  support. It is a standalone product that's not dependent on PowerShell, however, you can still use
+  your existing PowerShell DSC resources.
+
+- **PowerShell DSC 3.0 (preview)** is the version of DSC supported by the
+  [Azure Machine Configuration][01] on Linux.
+
+- **PowerShell DSC 2.0** is the version of DSC that shipped in PowerShell 7.
 
   With the release of PowerShell 7.2, the **PSDesiredStateConfiguration** module is no longer
   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 the 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.
-- DSC 3.0 is the new version of DSC. This version is a preview release that is still being
-  developed. Users working with non-Windows environments can expect cross-platform features in DSC
-  3.0. DSC 3.0 is the version that is supported by the [machine configuration][01] feature of Azure
-  Automanage.
 
-The documentation for DSC has been moved to a new location so that we can manage the DSC
-version-specific information separately from the versions of PowerShell.
+- **PowerShell DSC 1.1** is the legacy version of DSC that originally shipped in Windows PowerShell
+  5.1.
 
-See the new documentation in [Desired State Configuration 2.0][02].
+For more information, see the [Desired State Configuration][02] overview article.
 
 [01]: /azure/governance/machine-configuration/overview
 [02]: /powershell/dsc/overview

reference/index.yml

@@ -10,15 +10,15 @@ metadata:
   ms.collection: collection
   author: sdwheeler
   ms.author: sewhee
-  ms.date: 11/16/2023
+  ms.date: 03/18/2025
 
 # highlightedContent section (optional)
 # Maximum of 8 items
 highlightedContent:
 # itemType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | video | whats-new
   items:
     # Card
-    - title: Overview
+    - title: What is PowerShell?
       itemType: get-started
       url: /powershell/scripting/overview
     # Card
@@ -61,7 +61,7 @@ productDirectory:
           text: What's new in PowerShell
     # Card 2
     - title: PowerShell Utility modules
-      imageSrc: /media/common/ih_tools.svg
+      imageSrc: /media/common/i_tools.svg
       links:
         - url: /powershell/utility-modules/overview?view=ps-modules
           text: PowerShell utility modules
@@ -74,17 +74,17 @@ productDirectory:
         - url: /powershell/utility-modules/secretmanagement/overview?view=ps-modules
           text: SecretManagement overview
     # Card 3
-    - title: PowerShell DSC
-      imageSrc: /media/common/i_dev-ops.svg
+    - title: Desired State Configuration
+      imageSrc: /media/common/ih_tools.png
       links:
         - url: /powershell/scripting/dsc/overview
-          text: DSC Overview
-        - url: /powershell/dsc/overview?view=dsc-1.1
-          text: DSC 1.1 in Windows PowerShell
-        - url: /powershell/dsc/overview?view=dsc-2.0
-          text: DSC 2.0
+          text: PowerShell DSC Overview
         - url: /powershell/dsc/overview?view=dsc-3.0
-          text: DSC 3.0 (preview)
+          text: Microsoft DSC 3.0
+        - url: /powershell/dsc/overview?view=dsc-2.0
+          text: PowerShell DSC 2.0
+        - url: /powershell/dsc/overview?view=dsc-1.1
+          text: PowerShell DSC 1.1
         - url: https://dsccommunity.org/
           text: DSC Community
     # Card 4
@@ -94,8 +94,8 @@ productDirectory:
         - url: https://www.powershellgallery.com/
           text: PowerShell Gallery
         - url: /powershell/gallery/overview
-          text: What is the PowerShell Gallery
-        - url: /powershell/gallery/concepts/publishing-guidelines
+          text: Package management for PowerShell
+        - url: /powershell/gallery/powershellget/overview
           text: Best practices
         - url: /powershell/gallery/faqs
           text: FAQs