2 files changed, 9 insertions, 4 deletions

diff --git a/docs/helix-keys.md b/docs/helix-keys.md
index 28641a71..5edaccce 100644
--- a/docs/helix-keys.md
+++ b/docs/helix-keys.md
@@ -242,7 +242,9 @@ the selection the prompt opened on (`Pane.sel_snap`). That is what makes the
 selection a live preview, what makes typing a pattern one character at a time
 land where pasting it whole would, and what makes Esc a plain restore. Enter
 re-runs the final pattern down the same path, so a submit can never disagree
-with what is on screen. Engine: **mvzr** (`build.zig.zon`), a bytecode VM that
+with what is on screen. Pressed in a tag, column tag or workspace tag they
+select in that tag's own text, and so does `|` pipe it; `/` searches the
+body wherever it is pressed (`Pane.prompt_for`). Engine: **mvzr** (`build.zig.zon`), a bytecode VM that
 compiles a runtime pattern with no allocator.
 
 | Key | Behavior | Notes | Status |
diff --git a/docs/tags.md b/docs/tags.md
index 45a0cb3b..7c385c08 100644
--- a/docs/tags.md
+++ b/docs/tags.md
@@ -81,9 +81,12 @@ body. Up from a pane with nothing above it reaches its column's tag, then
 the workspace's; Down comes back the same way, and Left and Right walk the
 column tags.
 
-Search (`/`), pipe (`|`) and Save's path prompt are not typed into the tag:
-each gets a line of its own on the pane's notice band, with the body's
-insert-mode keys, and leaves the tag as it was.
+Search (`/`), `s`/`S`, pipe (`|`) and Save's path prompt are not typed into
+the tag: each gets a line of its own on the pane's notice band, with the
+body's insert-mode keys. Pressed in a tag, `s`, `S` and `|` answer for the
+tag's own text, as they do for a body, and a header's go on the active pane's
+band; `/` searches the body wherever it is pressed, as acme's Look from a tag
+does.
 
 Pane filenames and commands now have a single separator space rather than
 generated right-alignment padding. Intentionally customized spacing is kept.