From df0cf22347b66ce133dac02ce568848307dc5176 Mon Sep 17 00:00:00 2001
From: Peter Tripp <peter@zed.dev>
Date: Fri, 30 May 2025 17:09:55 -0400
Subject: [PATCH] Add powershell language docs (#31787)

Release Notes:

- N/A
---
 docs/src/SUMMARY.md              |  1 +
 docs/src/languages/powershell.md | 35 ++++++++++++++++++++++++++++++++
 2 files changed, 36 insertions(+)
 create mode 100644 docs/src/languages/powershell.md

diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md
index 21a1f721fe2fafd051cf2a117981789fa1d05c6c..fd8995f902abead986209744fe0b3e3ad8fc049b 100644
--- a/docs/src/SUMMARY.md
+++ b/docs/src/SUMMARY.md
@@ -111,6 +111,7 @@
 - [Nim](./languages/nim.md)
 - [OCaml](./languages/ocaml.md)
 - [PHP](./languages/php.md)
+- [PowerShell](./languages/powershell.md)
 - [Prisma](./languages/prisma.md)
 - [Proto](./languages/proto.md)
 - [PureScript](./languages/purescript.md)
diff --git a/docs/src/languages/powershell.md b/docs/src/languages/powershell.md
new file mode 100644
index 0000000000000000000000000000000000000000..d4d706425663c494e66ce0c18d8bf801d94cf910
--- /dev/null
+++ b/docs/src/languages/powershell.md
@@ -0,0 +1,35 @@
+# PowerShell
+
+PowerShell language support in Zed is provided by the community-maintained [Zed PowerShell extension](https://github.com/wingyplus/zed-powershell). Please report issues to: [github.com/wingyplus/zed-powershell/issues](https://github.com/wingyplus/zed-powershell/issues)
+
+- Tree-sitter: [airbus-cert/tree-sitter-powershell](https://github.com/airbus-cert/tree-sitter-powershell)
+- Language Server: [PowerShell/PowerShellEditorServices](https://github.com/PowerShell/PowerShellEditorServices)
+
+## Setup
+
+### Install PowerShell 7+ {#powershell-install}
+
+- macOS: `brew install powershell/tap/powershell`
+- Alpine: [Installing PowerShell on Alpine Linux](https://learn.microsoft.com/en-us/powershell/scripting/install/install-alpine)
+- Debian: [Install PowerShell on Debian Linux](https://learn.microsoft.com/en-us/powershell/scripting/install/install-debian)
+- RedHat: [Install PowerShell on RHEL](https://learn.microsoft.com/en-us/powershell/scripting/install/install-rhel)
+- Ubuntu: [Install PowerShell on RHEL](https://learn.microsoft.com/en-us/powershell/scripting/install/install-ubuntu)
+- Windows: [Install PowerShell on Windows](https://learn.microsoft.com/en-us/powershell/scripting/install/installing-powershell-on-windows)
+
+The Zed PowerShell extension will default to the `pwsh` executable found in your path.
+
+### Install PowerShell Editor Services (Optional) {#powershell-editor-services}
+
+The Zed PowerShell extensions will attempt to download [PowerShell Editor Services](https://github.com/PowerShell/PowerShellEditorServices) automatically.
+
+If want to use a specific binary, you can specify in your that in your Zed settings.json:
+
+```json
+  "lsp": {
+    "powershell-es": {
+      "binary": {
+        "path": "/path/to/PowerShellEditorServices"
+      }
+    }
+  }
+```