update zed config & docs to use the project version of basedpyright again. i incorrectly assumed this was no longer necessary

Author: DetachHead

.zed/settings.json

@@ -7,20 +7,22 @@
       ],
       "format_on_save": "on",
       "formatter": [
-        {
-          "code_actions": {
-            "source.organizeImports.ruff": true,
-            "source.fixAll.ruff": true
-          }
-        },
         {
           "language_server": {
             "name": "ruff"
           }
         }
-      ]        
+      ]
+    }
+  },
+  "lsp": {
+    "basedpyright": {
+      "binary": {
+        "path": ".venv/bin/basedpyright-langserver",
+        "arguments": ["--stdio"]
+      }
     }
-  }, 
+  },
   "auto_install_extensions": {
     "ruff": true
   }

docs/installation/ides.md

@@ -183,3 +183,22 @@ You can verify the active configuration by running `hx --health python`
 ## Zed
 
 basedpyright is the default language server for python in zed. [see the docs](https://zed.dev/docs/languages/python#basedpyright) for more information.
+
+??? tip "adding basedpyright as a development dependency to your project"
+
+    we highly recommend installing and pinning basedpyright as a dev dependency for your project and using project settings (`.zed/settings.json`) to confiigure zed to use the that version instead of a globally installed version. this enaures that zed doesn't automatically update basedpyright unexpectedly, which can result in different errors being reported in your IDE than your CI.
+
+    ```json title=".zed/settings.json"
+    {
+        "lsp": {
+            "basedpyright": {
+                "binary": {
+                    "path": ".venv/bin/basedpyright-langserver",
+                    "arguments": ["--stdio"]
+                }
+            }
+        }
+    }
+    ```
+
+    you should commit this file so that these settings are automatically applied for other developers working on your project.