docs: add deprecation warning to gateway docs and direct to toolbox (#21210)

jcjiang · david-fraley · web-flow · commit 05b02cf88744 · 2025-12-10T17:11:25.000Z
See a preview link here: https://coder.com/docs/@gateway-deprecation-docs/user-guides/workspace-access/jetbrains/gateway --------- Co-authored-by: david-fraley <67079030+david-fraley@users.noreply.github.com>
diff --git a/docs/user-guides/workspace-access/jetbrains/gateway.md b/docs/user-guides/workspace-access/jetbrains/gateway.md
@@ -1,5 +1,8 @@
 ## JetBrains Gateway
 
+> [! WARNING]
+> Using Coder through JetBrains Gateway is not recommended at this time. Instead, we suggest using [JetBrains Toolbox](https://coder.com/docs/user-guides/workspace-access/jetbrains/toolbox) for stability and performance benefits. If you are currently using Gateway, we recommend [migration](https://www.jetbrains.com/help/toolbox-app/jetbrains-gateway-migrations-guide.html).
+
 JetBrains Gateway is a compact desktop app that allows you to work remotely with
 a JetBrains IDE without downloading one. Visit the
 [JetBrains Gateway website](https://www.jetbrains.com/remote-development/gateway/)
