6daa541e77
## Summary
Comprehensive remediation of 146 documentation files to align with Zed's
documentation conventions and brand voice guidelines.
## Changes
### YAML Frontmatter
- Added `title` and `description` frontmatter to all docs missing it
### Settings UI Pattern
- Updated 48+ files to show Settings Editor before JSON examples
- Pattern: `Configure X in Settings ({#kb zed::OpenSettings}), or add to
your settings file:`
- Added `([how to edit](./configuring-zed.md#settings-files))` links for
JSON-only settings
### Brand Voice Fixes
- Removed exclamation points (command-palette, key-bindings, repl,
privacy-and-security, etc.)
- Simplified em dash chains to parentheticals (environment,
troubleshooting, agent-panel, etc.)
- Fixed marketing language (yarn.md intro, development/linux.md)
### Terminology Alignment
- `settings UI` -> `Settings Editor`
- `sidebar` -> specific panel names (Project Panel, Collab Panel)
- `directory` -> `folder` in non-technical contexts
- `workspace` -> `project` in non-LSP contexts
- `Command Palette` -> `command palette` (lowercase)
### Callout Standardization
- Converted various callout formats to standard `> **Note:**` pattern
## Related
Depends on conventions established in #49176.
Release Notes:
- N/A
2.9 KiB
| title | description |
|---|---|
| Zed on Windows | Get the latest stable builds via the download page. If you want to download our preview build, you can find it on its [releases p... |
Zed on Windows
Installing Zed
Get the latest stable builds via the download page. If you want to download our preview build, you can find it on its releases page. After the first manual installation, Zed will periodically check for install updates.
You can also build zed from source, see these docs for instructions.
Package managers
Additionally, you can install Zed using winget:
winget install -e --id ZedIndustries.Zed
Uninstall
- Installed via installer: Use
Settings→Apps→Installed apps, search for Zed, and click Uninstall. - Built from source: Remove the build output directory you created (e.g., your target/install folder).
Your settings and extensions live in your user profile. When uninstalling, you can choose to keep or remove them.
Remote Development (SSH)
Zed supports remote development on Windows through both SSH and WSL. You can connect to remote servers via SSH or work with files inside WSL distributions directly from Zed.
For detailed instructions on setting up and using remote development features, including SSH configuration, WSL setup, and troubleshooting, see the Remote Development documentation.
Troubleshooting
Zed fails to start or shows a blank window
- Check that your hardware and operating system version are compatible with Zed. See our installation guide for more information.
- Update your GPU drivers from your GPU vendor (Intel/AMD/NVIDIA/Qualcomm).
- Ensure hardware acceleration is enabled in Windows and not blocked by third‑party software.
- Try launching Zed with no extensions or custom settings to isolate conflicts.
Terminal issues
If activation scripts don’t run, update to the latest version and verify your shell profile files are not exiting early. For Git operations, confirm Git Bash or PowerShell is available and on PATH.
SSH remoting problems
When prompted for credentials, use the graphical askpass dialog. If it doesn’t appear, check for credential manager conflicts and that GUI prompts aren’t blocked by your terminal.
Graphics issues
Zed fails to open / degraded performance
Zed requires a DirectX 11 compatible GPU to run. If Zed fails to open, your GPU may not meet the minimum requirements.
To check if your GPU supports DirectX 11, run the following command:
dxdiag
This will open the DirectX Diagnostic Tool, which shows the DirectX version your GPU supports under System → System Information → DirectX Version.
If you're running Zed inside a virtual machine, it will use the emulated adapter provided by your VM. While Zed will work in this environment, performance may be degraded.