From 2c82e6c6ae2cd7472de3598c2bf3bb2a4e9560d2 Mon Sep 17 00:00:00 2001
From: Filip <34747899+neriousy@users.noreply.github.com>
Date: Sun, 1 Feb 2026 17:52:43 +0100
Subject: docs: prefer wsl over native windows stuff (#11637)

---
 packages/web/src/content/docs/index.mdx | 4 ++++
 1 file changed, 4 insertions(+)

(limited to 'packages/web/src/content/docs/index.mdx')

diff --git a/packages/web/src/content/docs/index.mdx b/packages/web/src/content/docs/index.mdx
index 8b3d3a9c8..bb3b8cb5d 100644
--- a/packages/web/src/content/docs/index.mdx
+++ b/packages/web/src/content/docs/index.mdx
@@ -89,6 +89,10 @@ You can also install it with the following commands:
 
 #### Windows
 
+:::tip[Recommended: Use WSL]
+For the best experience on Windows, we recommend using [Windows Subsystem for Linux (WSL)](/docs/windows-wsl). It provides better performance and full compatibility with OpenCode's features.
+:::
+
 - **Using Chocolatey**
 
   ```bash
-- 
cgit v1.2.3

