Show, don't tell: the guide, the tutor, scripting, setup and the landing lead show an example first and cut the prose it makes redundant; the reference's 9P tree and REPLs name Look and Exec

Co-Authored-By: Claude Opus 5.5 <[email protected]>

1 files changed, 10 insertions, 15 deletions

diff --git a/src/tutor.txt b/src/tutor.txt
index 8159b781..f4eb8ba3 100644
--- a/src/tutor.txt
+++ b/src/tutor.txt
@@ -175,12 +175,11 @@ abcdef
 # after
 abcdef
 
- A number typed FIRST is a count, and only some keys take one,
- among them the motions, f/F/t/T and the Alt-. that repeats them,
- gg/gj/gk, x, o/O, > and <, p/P, R, Ctrl-a/Ctrl-x, the cursor-list
- keys C and ( ), q and the . repeat. Elsewhere it is swallowed: 3d
- deletes once, 3i types once. 0 is always line start and never starts a
- count. Ctrl-d/u/f ignore counts: a page is a page.
+ 3l moves three: a number typed FIRST is a count. The motions,
+ f/F/t/T and Alt-., gg/gj/gk, x, o/O, > <, p/P, R, Ctrl-a/Ctrl-x,
+ C ( ), q and . take one; any other key swallows it (3d deletes
+ once, 3i types once). 0 is always line start; Ctrl-d/u/f ignore
+ counts.
 
 # keys: 3 l i Z esc
 # before
@@ -276,10 +275,9 @@ typed
 = 9.6 SPC — THE LEADER                                           =
 -----------------------------------------------------------------
 
- Nearly every builtin has a NAME you can `Exec` wherever text lives
- and a KEY PATH you can press. SPC in NORMAL mode starts the path;
- what you have typed shows on the message row until it fires. Esc
- abandons it, and so does any key that leads nowhere.
+ SPC f s is `Save`: nearly every builtin has a key path as well as
+ a name. What you have typed shows on the message row; Esc, or a key
+ that leads nowhere, abandons it.
 
    SPC ?        list every path
    SPC d        `Del`       SPC q      `Exit`
@@ -300,8 +298,7 @@ typed
 =================================================================
 
  Every session is a virtual filesystem, served over 9P: a program that
- opens files IS an extension, with no plugin API. Pane shells get
- $PARDES_9P (the socket) and $PARDES_PANE (their pane's serial).
+ opens files IS an extension.
 
    9ns --mntgen          mount every session (9ns is cloud9's)
    m=$PARDES_MOUNT                   the session, under 9ns
@@ -323,9 +320,7 @@ typed
 =================================================================
 
  MODES      blank NORMAL, ^ INSERT, $ RAW; each pane keeps its own
-            Esc and Shift-Esc: see the guide's Modes table
-                (Shift-Esc needs the kitty keyboard protocol or the
-                GUI; elsewhere it is a plain Esc)
+            Esc in NORMAL goes back a pane (the guide's Modes table)
             Ctrl-b toggles RAW and NORMAL
 
  MOUSE      L select/focus   M `Exec`   R `Look`