From 7af13b3ca8a19ca19fb1e5e3ae369d9e28cd5ca5 Mon Sep 17 00:00:00 2001 From: Victor Raton <43411882+victorfernandesraton@users.noreply.github.com> Date: Thu, 30 Jul 2026 00:19:59 -0300 Subject: [PATCH] docs: Add note about toolchain selection for Python REPL (#60549) # Objective Improve documentation to inform about toolchain in repl session and avoid issues like https://github.com/zed-industries/zed/issues/60465 ## Solution - Add a note in documentation about using toolchain for change python enviroment ## Self-Review Checklist: - [x] I've reviewed my own diff for quality, security, and reliability Release Notes: - N/A --------- Co-authored-by: Kunall Banerjee --- docs/src/repl.md | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/docs/src/repl.md b/docs/src/repl.md index 255e1a40ad..9eb6428443 100644 --- a/docs/src/repl.md +++ b/docs/src/repl.md @@ -73,12 +73,6 @@ style.use('ggplot') #### Global environment -
- -On macOS, your system Python will _not_ work. Either set up [pyenv](https://github.com/pyenv/pyenv?tab=readme-ov-file#installation) or use a virtual environment. - -
- To set up your current Python to have an available kernel, run: ```sh @@ -102,6 +96,8 @@ pip install ipykernel python -m ipykernel install --user --name myenv --display-name "Python (myenv)" ``` +> Note: **On macOS, your system Python will _not_ work**. Either set up [pyenv](https://github.com/pyenv/pyenv?tab=readme-ov-file#installation) or use a virtual environment. Zed uses separate selections for the Python [toolchain](./configuring-languages.md#toolchains) and REPL kernel. If diagnostics differ from the REPL, align the toolchain with the kernel using {#action toolchain::Select}. Read more about the [toolchain selector for Python](./languages/python.md#selecting-a-toolchain). + ### R (Ark Kernel) {#r-ark} Install [Ark](https://github.com/posit-dev/ark/releases) by downloading the release for your operating system. For example, for macOS just unpack `ark` binary and put it into `/usr/local/bin`. Then run: