diff --git a/docs/editors/setup.md b/docs/editors/setup.md
index 17652539c3..8e37ea42ed 100644
--- a/docs/editors/setup.md
+++ b/docs/editors/setup.md
@@ -361,6 +361,22 @@ and [LSP-ruff](https://github.com/sublimelsp/LSP-ruff) package.
 
 ## PyCharm
 
+Starting with version 2025.3, PyCharm supports Ruff out of the box:
+
+1. Go to **Python | Tools | Ruff** 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 Ruff package for the selected interpreter, click _Install Ruff_.
+
+    **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#ruff).
+
 ### Via External Tool
 
 Ruff can be installed as an [External Tool](https://www.jetbrains.com/help/pycharm/configuring-third-party-tools.html)