From d3d0354e3c4495e8a2d50875b18a5690f22dae84 Mon Sep 17 00:00:00 2001 From: Vamsi-2581 <245859299+Vamsi-2581@users.noreply.github.com> Date: Wed, 28 Oct 2026 17:52:34 +0530 Subject: [PATCH] docs: clarify Jupyter notebook mode colors Clarify that Command and Edit modes are identified by mode and shortcut, while border colors can vary by platform and theme. Remove color-based shortcuts from the related lesson guidance. --- episodes/01-run-quit.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/episodes/01-run-quit.md b/episodes/01-run-quit.md index 258fb716c7..82bf6a528d 100644 --- a/episodes/01-run-quit.md +++ b/episodes/01-run-quit.md @@ -276,10 +276,10 @@ a "text cell" is one that contains ordinary prose written for human beings. ## The Notebook has Command and Edit modes. -- If you press Esc and Return alternately, the outer border of your code cell will change from gray to blue. -- These are the **Command** (gray) and **Edit** (blue) modes of your notebook. +- If you press Esc and Return alternately, the outer border of your code cell will change color. +- These are the **Command** and **Edit** modes of your notebook. Their border colors can vary by platform and theme; on macOS, Command mode may appear blue and Edit mode gray. - Command mode allows you to edit notebook-level features, and Edit mode changes the content of cells. -- When in Command mode (esc/gray), +- When in Command mode (after pressing Esc), - The b key will make a new cell below the currently selected cell. - The a key will make one above. - The x key will delete the current cell. @@ -300,11 +300,11 @@ Use the shortcuts to undo the last cell operation you performed. ## Solution -Command mode has a grey border and Edit mode has a blue border. +Command and Edit mode border colors can vary by platform and theme. On macOS, Command mode may appear blue while Edit mode may appear gray. Use Esc and Return to switch between modes. -You need to be in Command mode (Press Esc if your cell is blue). Type b or a. -You need to be in Command mode (Press Esc if your cell is blue). Type x. -You need to be in Command mode (Press Esc if your cell is blue). Type z. +You need to be in Command mode (press Esc if your cell is in Edit mode). Type b or a. +You need to be in Command mode (press Esc if your cell is in Edit mode). Type x. +You need to be in Command mode (press Esc if your cell is in Edit mode). Type z. @@ -314,10 +314,10 @@ You need to be in Command mode (Press Esc if your cell is blue). Typ ### Use the keyboard and mouse to select and edit cells. -- Pressing the Return key turns the border blue and engages Edit mode, which allows +- Pressing the Return key switches to Edit mode, which allows you to type within the cell. - Because we want to be able to write many lines of code in a single cell, - pressing the Return key when in Edit mode (blue) moves the cursor to the next line + pressing the Return key when in Edit mode moves the cursor to the next line in the cell just like in a text editor. - We need some other way to tell the Notebook we want to run what's in the cell. - Pressing Shift\+Return together will execute the contents of the cell. @@ -330,11 +330,11 @@ You need to be in Command mode (Press Esc if your cell is blue). Typ - A simple plain-text format for writing lists, links, and other things that might go into a web page. - Equivalently, a subset of HTML that looks like what you'd send in an old-fashioned email. -- Turn the current cell into a Markdown cell by entering the Command mode (Esc/gray) +- Turn the current cell into a Markdown cell by entering the Command mode (Esc) and press the M key. - `In [ ]:` will disappear to show it is no longer a code cell and you will be able to write in Markdown. -- Turn the current cell into a Code cell by entering the Command mode (Esc/gray) and +- Turn the current cell into a Code cell by entering the Command mode (Esc) and press the y key. ### Markdown does most of what HTML does.