From cb76a5eac8dcc570da055ef617d8bb932dc58624 Mon Sep 17 00:00:00 2001
From: charliecloudberry <145581317+charliecloudberry@users.noreply.github.com>
Date: Wed, 12 Nov 2025 23:24:59 +0100
Subject: [PATCH] Add PyCharm setup instructions to editors documentation
 (#1533)

## Summary

Support for ty was recently added to PyCharm and I want to update ty's
documentation accordingly.

## Test Plan

n/a

---------

Co-authored-by: Carl Meyer <carl@astral.sh>
---
 docs/editors.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/docs/editors.md b/docs/editors.md
index f4d2fdf..815ba59 100644
--- a/docs/editors.md
+++ b/docs/editors.md
@@ -79,6 +79,24 @@ You can override the `ty` executable Zed uses by setting `lsp.ty.binary`:
 
 More information in [Zed's documentation](https://zed.dev/docs/languages/python#configure-python-language-servers-in-zed).
 
+## PyCharm
+
+Starting with version 2025.3, PyCharm users can enable native ty support in the settings:
+
+1. Go to **Python | Tools | ty** in the Settings dialog.
+
+1. Select the **Enable** checkbox.
+
+1. In the Execution mode setting, select how PyCharm should search for the executable:
+
+    **Interpreter** mode: PyCharm searches for an executable installed in your interpreter. To install the ty package for the selected interpreter, click _Install ty_.
+
+    **Path** mode: PyCharm searches for an executable in `$PATH`. If the executable is not found, you can specify the path by clicking the Browse... icon.
+
+1. Select which options should be enabled.
+
+For more information, refer to [PyCharm documentation](https://www.jetbrains.com/help/pycharm/2025.3/lsp-tools.html#ty).
+
 ## Other editors
 
 ty can be used with any editor that supports the [language server