@@ -75,30 +75,30 @@ Zed supports machines with Intel (x86_64) or Apple (aarch64) processors that mee
### Linux
-Zed supports 64bit Intel/AMD (x86_64) and 64Bit ARM (aarch64) processors.
+Zed supports 64-bit Intel/AMD (x86_64) and 64-bit Arm (aarch64) processors.
-Zed requires a Vulkan 1.3 driver, and the following desktop portals:
+Zed requires a Vulkan 1.3 driver and the following desktop portals:
- `org.freedesktop.portal.FileChooser`
- `org.freedesktop.portal.OpenURI`
-- `org.freedesktop.portal.Secret`, or `org.freedesktop.Secrets`
+- `org.freedesktop.portal.Secret` or `org.freedesktop.Secrets`
### Windows
-Zed supports the follow Windows releases:-| Version | Microsoft Status | Zed Status |-| ------------------------- | ------------------ | ------------------- |-| Windows 11 (all releases) | Supported | Supported |-| Windows 10 (64-bit) | Supported | Supported |
+Zed supports the following Windows releases:
+| Version | Zed Status |
+| ------------------------- | ------------------- |
+| Windows 11, version 22H2 and later | Supported |
+| Windows 10, version 1903 and later | Supported |
+
+A 64-bit operating system is required to run Zed.
#### Windows Hardware
-Zed supports machines with Intel or AMD 64-bit (x86_64) processors that meet the above Windows requirements:
+Zed supports machines with x64 (Intel, AMD) or Arm64 (Qualcomm) processors that meet the following requirements:
-- Windows 11 (64-bit)-- Windows 10 (64-bit)
- Graphics: A GPU that supports DirectX 11 (most PCs from 2012+).
-- Driver: Current NVIDIA/AMD/Intel driver (not the Microsoft Basic Display Adapter).
+- Driver: Current NVIDIA/AMD/Intel/Qualcomm driver (not the Microsoft Basic Display Adapter).
### FreeBSD
@@ -23,7 +23,8 @@ For detailed instructions on setting up and using remote development features, i
### Zed fails to start or shows a blank window
-- Update your GPU drivers from your GPU vendor (Intel/AMD/NVIDIA).
+- Check that your hardware and operating system version are compatible with Zed. See our [installation guide](./installation.md) 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.
@@ -39,14 +40,14 @@ When prompted for credentials, use the graphical askpass dialog. If it doesn’t
#### Zed fails to open / degraded performance
-Zed requires a DX11 compatible GPU to run, if Zed doesn't open for you it is possible that your GPU does not meet the minimum requirements.
+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 DX11, you can use the following command:
+To check if your GPU supports DirectX 11, run the following command:
```
dxdiag
```
-Which will open the diagnostic tool that will show the minimum DirectX version your GPU supports under `System` → `System Information` → `DirectX Version`.
+This will open the DirectX Diagnostic Tool, which shows the DirectX version your GPU supports under `System` → `System Information` → `DirectX Version`.
-You might also be trying to run Zed inside a virtual machine in which case it will use the emulated adapter that your VM provides, while Zed will work the performance will be degraded.
+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.