Fixes #12203 - Add the Monad Manifesto

reference/docs-conceptual/developer/monad-manifesto.md

@@ -0,0 +1,27 @@
+---
+description: This Language Specification describe the syntax, semantics, and behavior of the PowerShell language.
+ms.date: 07/07/2025
+title: The Monad Manifesto
+---
+# The Monad Manifesto
+
+Jeffrey Snover, the inventor of PowerShell, wrote the Monad Manifesto to explain his vision for
+PowerShell and how it would change the way we manage systems. You can read more about why he wrote
+it in his [Monad Manifesto](https://www.jsnover.com/blog/2011/10/01/monad-manifesto/) blog post.
+
+In that post, he explained how hard it was to communicate the vision for PowerShell to
+widely-distrubted development teams. The development teams didn't understand the vision. Writing the
+Manifesto forced him to be clear about what problem being addressed, the core principles of the
+design, how to address the problem, who would benefit from it, and why.
+
+Use the following link to download a copy of the manifesto.
+
+- [Monad Manifesto][33].
+
+This is an important document for PowerShell and is provided for historical context. This is a
+version of the original Monad Manifesto that articulated the long-term vision and started the
+development effort that became PowerShell. PowerShell has delivered on many of the elements
+described in this document.
+
+<!-- link references -->
+[33]: https://github.com/MicrosoftDocs/PowerShell-Docs/blob/main/assets/MonadManifesto.pdf

reference/docs-conceptual/overview.md

@@ -16,11 +16,11 @@ PowerShell is a modern command shell that includes the best features of other po
 most shells that only accept and return text, PowerShell accepts and returns .NET objects. The shell
 includes the following features:
 
-- Robust command-line [history][01]
-- Tab completion and command prediction (See [about_PSReadLine][02])
-- Supports command and parameter [aliases][03]
-- [Pipeline][04] for chaining commands
-- In-console [help][05] system, similar to Unix `man` pages
+- Robust command-line [history][09]
+- Tab completion and command prediction (See [about_PSReadLine][18])
+- Supports command and parameter [aliases][05]
+- [Pipeline][11] for chaining commands
+- In-console [help][14] system, similar to Unix `man` pages
 
 ## Scripting language
 
@@ -30,10 +30,10 @@ the .NET Common Language Runtime (CLR). All inputs and outputs are .NET objects.
 text output to extract information from output. The PowerShell scripting language includes the
 following features:
 
-- Extensible through [functions][06], [classes][07], [scripts][08], and [modules][09]
-- Extensible [formatting system][10] for easy output
-- Extensible [type system][11] for creating dynamic types
-- Built-in support for common data formats like [CSV][12], [JSON][13], and [XML][14]
+- Extensible through [functions][08], [classes][06], [scripts][12], and [modules][10]
+- Extensible [formatting system][07] for easy output
+- Extensible [type system][13] for creating dynamic types
+- Built-in support for common data formats like [CSV][15], [JSON][16], and [XML][17]
 
 ## Automation platform
 
@@ -42,78 +42,88 @@ manage almost any technology you work with. For example:
 
 Microsoft
 
-- [Azure][15]
-- [Windows][16]
-- [Exchange][17]
-- [SQL][18]
+- [Azure][02]
+- [Windows][25]
+- [Exchange][04]
+- [SQL][27]
 
 Third-party
 
-- [AWS][19]
-- [VMware][20]
-- [Google Cloud][21]
+- [AWS][30]
+- [VMware][32]
+- [Google Cloud][31]
 
 ### Configuration management
 
-PowerShell Desired State Configuration ([DSC][22]) is a management framework in PowerShell that
+PowerShell Desired State Configuration ([DSC][20]) is a management framework in PowerShell that
 enables you to manage your enterprise infrastructure with configuration as code. With DSC, you can:
 
-- Create declarative [configurations][23] and custom scripts for repeatable deployments
+- Create declarative [configurations][19] and custom scripts for repeatable deployments
 - Enforce configuration settings and report on configuration drift
-- Deploy configuration using [push or pull][24] models
+- Deploy configuration using [push or pull][21] models
+
+## Monad Manifesto
+
+Jeffrey Snover, the inventor of PowerShell, wrote the Monad Manifesto to explain his vision for
+PowerShell and how it would change the way we manage systems. Use the following link to download a
+copy of the [Monad Manifesto][33].
+
+This is a version of the original Monad Manifesto that articulated the long-term vision and started
+the development effort that became PowerShell. PowerShell has delivered on many of the elements
+described in this document.
 
 ## Next steps
 
 ### Getting started
 
 Are you new to PowerShell and don't know where to start? Take a look at these resources.
 
-- [Installing PowerShell][25]
-- [Discover PowerShell][26]
-- [PowerShell 101][27]
-- [Microsoft Virtual Academy videos][28]
-- [PowerShell Learn modules][29]
+- [Installing PowerShell][22]
+- [Discover PowerShell][29]
+- [PowerShell 101][23]
+- [Microsoft Virtual Academy videos][26]
+- [PowerShell Learn modules][28]
 
 ### PowerShell in action
 
 Take a look at how PowerShell is being used in different scenarios and on different platforms.
 
-- [PowerShell remoting over SSH][30]
-- [Getting started with Azure PowerShell][31]
-- [Building a CI/CD pipeline with DSC][32]
-- [Managing Microsoft Exchange][33]
+- [PowerShell remoting over SSH][24]
+- [Getting started with Azure PowerShell][03]
+- [Building a CI/CD pipeline with DSC][01]
+- [Managing Microsoft Exchange][04]
 
 <!-- link references -->
-[01]: /powershell/module/microsoft.powershell.core/about/about_history
-[02]: /powershell/module/psreadline/about/about_psreadline
-[03]: /powershell/module/microsoft.powershell.core/about/about_aliases
-[04]: /powershell/module/microsoft.powershell.core/about/about_pipelines
-[05]: /powershell/module/microsoft.powershell.core/get-help
-[06]: /powershell/module/microsoft.powershell.core/about/about_functions_advanced
-[07]: /powershell/module/microsoft.powershell.core/about/about_classes
-[08]: /powershell/module/microsoft.powershell.core/about/about_scripts
-[09]: /powershell/module/microsoft.powershell.core/about/about_modules
-[10]: /powershell/module/microsoft.powershell.core/about/about_format.ps1xml
-[11]: /powershell/module/microsoft.powershell.core/about/about_types.ps1xml
-[12]: /powershell/module/microsoft.powershell.utility/convertfrom-csv
-[13]: /powershell/module/microsoft.powershell.utility/convertfrom-json
-[14]: /powershell/module/microsoft.powershell.utility/convertto-xml
-[15]: /powershell/azure
-[16]: /powershell/windows/get-started
-[17]: /powershell/exchange/exchange-management-shell
-[18]: /sql/powershell/sql-server-powershell
-[19]: https://aws.amazon.com/powershell/
-[20]: https://developer.broadcom.com/powercli
-[21]: https://cloud.google.com/powershell/
-[22]: /powershell/scripting/dsc/overview/dscforengineers
-[23]: /powershell/scripting/dsc/configurations/configurations
-[24]: /powershell/scripting/dsc/pull-server/enactingconfigurations
-[25]: /powershell/scripting/install/installing-powershell
-[26]: discover-powershell.md
-[27]: /powershell/scripting/learn/ps101/00-introduction
-[28]: /shows/browse?terms=powershell
-[29]: /training/browse/?terms=PowerShell
-[30]: /powershell/scripting/learn/remoting/ssh-remoting-in-powershell-core
-[31]: /powershell/azure/get-started-azureps
-[32]: /azure/devops/pipelines/release/dsc-cicd
-[33]: /powershell/exchange/exchange-management-shell
+[01]: /azure/devops/pipelines/release/dsc-cicd
+[02]: /powershell/azure
+[03]: /powershell/azure/get-started-azureps
+[04]: /powershell/exchange/exchange-management-shell
+[05]: /powershell/module/microsoft.powershell.core/about/about_aliases
+[06]: /powershell/module/microsoft.powershell.core/about/about_classes
+[07]: /powershell/module/microsoft.powershell.core/about/about_format.ps1xml
+[08]: /powershell/module/microsoft.powershell.core/about/about_functions_advanced
+[09]: /powershell/module/microsoft.powershell.core/about/about_history
+[10]: /powershell/module/microsoft.powershell.core/about/about_modules
+[11]: /powershell/module/microsoft.powershell.core/about/about_pipelines
+[12]: /powershell/module/microsoft.powershell.core/about/about_scripts
+[13]: /powershell/module/microsoft.powershell.core/about/about_types.ps1xml
+[14]: /powershell/module/microsoft.powershell.core/get-help
+[15]: /powershell/module/microsoft.powershell.utility/convertfrom-csv
+[16]: /powershell/module/microsoft.powershell.utility/convertfrom-json
+[17]: /powershell/module/microsoft.powershell.utility/convertto-xml
+[18]: /powershell/module/psreadline/about/about_psreadline
+[19]: /powershell/scripting/dsc/configurations/configurations
+[20]: /powershell/scripting/dsc/overview/dscforengineers
+[21]: /powershell/scripting/dsc/pull-server/enactingconfigurations
+[22]: /powershell/scripting/install/installing-powershell
+[23]: /powershell/scripting/learn/ps101/00-introduction
+[24]: /powershell/scripting/learn/remoting/ssh-remoting-in-powershell-core
+[25]: /powershell/windows/get-started
+[26]: /shows/browse?terms=powershell
+[27]: /sql/powershell/sql-server-powershell
+[28]: /training/browse/?terms=PowerShell
+[29]: discover-powershell.md
+[30]: https://aws.amazon.com/powershell/
+[31]: https://cloud.google.com/powershell/
+[32]: https://developer.broadcom.com/powercli
+[33]: https://github.com/MicrosoftDocs/PowerShell-Docs/blob/main/assets/MonadManifesto.pdf

reference/docs-conceptual/toc.yml

@@ -451,6 +451,8 @@ items:
             href: lang-spec/chapter-16.md
       - name: Legacy PowerShell SDK
         href: developer/toc.yml
+      - name: The Monad Manifesto
+        href: developer/monad-manifesto.md
   - name: Docs Contributor's Guide
     items:
       - name: Overview