From c70bfdd7be4ded48ef33f962f7e4cbea0e6bd009 Mon Sep 17 00:00:00 2001 From: Nils Pukropp Date: Thu, 22 Oct 2026 17:09:25 +0200 Subject: [PATCH] docs: the guide around four things and two screens, new screenshots, the plan closed The guide opens with documents, cards, notes and diary entries, and the documents and plan screens, then walks the day with the scratchpad, the info sheet and cards linked both ways. The README and the wiki's home say the same in short, and show the scratchpad and the info sheet. The screenshot script drops its Alt keys and takes both. PLAN.md records the simplification's slices, what was left of its navigation fixes, and the backlog fitted to the model. --- PLAN.md | 93 +++++++++++++-------- README.md | 23 +++-- docs/images/agenda.png | Bin 122618 -> 112909 bytes docs/images/board.png | Bin 124835 -> 122401 bytes docs/images/calendar.png | Bin 122737 -> 122222 bytes docs/images/document.png | Bin 114052 -> 116858 bytes docs/images/editor.png | Bin 80141 -> 75570 bytes docs/images/file-certificate.png | Bin 81619 -> 81503 bytes docs/images/file-table.png | Bin 94245 -> 93848 bytes docs/images/help.png | Bin 253924 -> 178315 bytes docs/images/history.png | Bin 83869 -> 86854 bytes docs/images/info.png | Bin 0 -> 105992 bytes docs/images/login.png | Bin 38395 -> 38038 bytes docs/images/math.png | Bin 80769 -> 78006 bytes docs/images/mobile-document.png | Bin 88994 -> 88045 bytes docs/images/mobile-tree.png | Bin 34640 -> 34391 bytes docs/images/overview.png | Bin 65600 -> 65846 bytes docs/images/scratch.png | Bin 0 -> 52961 bytes docs/images/search.png | Bin 76645 -> 81552 bytes docs/images/tiles.png | Bin 132891 -> 133707 bytes docs/images/typst.png | Bin 78455 -> 75804 bytes docs/wiki/Guide.md | 134 +++++++++++++++++++++--------- docs/wiki/Home.md | 11 ++- docs/wiki/Spaces-and-Documents.md | 10 ++- docs/wiki/Writing.md | 7 +- scripts/screenshots.ts | 31 +++++-- 26 files changed, 214 insertions(+), 95 deletions(-) create mode 100644 docs/images/info.png create mode 100644 docs/images/scratch.png diff --git a/PLAN.md b/PLAN.md index b6a4955..57d075a 100644 --- a/PLAN.md +++ b/PLAN.md @@ -1,15 +1,54 @@ # Findings, possible bugs, and what comes next -Written on 2026-10-21, after the seven slices of the feature plan had landed -(trash `8ffad63`, revisions `fc2be66`, links `a42f907`, capture tokens -`f629f5a`, diary `824f2bb`, recurring cards `6673298`, search in files -`909abf5`). That plan has fully landed, and git keeps it. +## The simplification, done -These came out of writing the wiki, taking the screenshots against a fresh -workspace, and probing the API on a throwaway server. All of them are fixed -now, except two limits of search noted at the end of the list. +Written on 2026-10-22. The app had grown slice by slice to about 85 commands, +60 browse keys and 11 overlays, with the same idea modelled two or three times: +text in three editors, files in two places, cards that pointed at a document +the document could not see, four inboxes, two layout systems, and keys +documented by hand in seven places. A plan in eleven slices made the same +features out of fewer things, one place for each, and one key grammar. Every +one has landed: -## Fixed +| | slice | commit | +| --- | --- | --- | +| 0 | the audit's fixes: `Ctrl-P` keeps its query, `:today` by the server's day, card descriptions resolve links | `7f8a381` | +| 1 | one keymap table drives the dispatch, help, the footers, the rail and the wiki; a mode stack replaces the flags | `0eabcb2` | +| 2 | one `Sheet` component; the info sheet holds headings, versions, backlinks and sharing | `26b3c68` | +| 3 | the board, agenda, calendar and a card's back are tiles; the special workspace is gone | `5684614` | +| 4 | documents and cards linked both ways: `gc`, card verbs on the card in focus, cards in search | `b8b3641` | +| 5 | one editor for documents, descriptions and notes, all saving themselves | `ccc9102` | +| 6 | the scratchpad is the inbox, with three ways out and a search | `2233fa4` | +| 7 | a file belongs to a node; the media browser is gone | `d8e72c6` | +| 8 | `!` means force or everything only; merged commands; a settings sheet; two-level help | `7f8d625` | +| 9 | the store split into parts under one `Workspace` | `b110701` | +| 9b | fixes from daily use: `Ctrl-h/j/k/l` between tiles, `Ctrl-Q` from anywhere, the plan screen | `650fc40` | +| 10 | the docs: the guide around the four things, the README, new screenshots | this commit | + +The model it leaves: a **document** is the thorough record, a **card** the +short actionable summary of work, a **note** a thought not sorted yet, and a +**diary entry** a document about a day. A file sits in a folder or belongs to +its document. The documents and the plan each have a screen, and the +scratchpad comes down over either. + +### Left over from the plan, not started + +These were in the plan's navigation fixes, outside the numbered slices: + +- The list groups documents by day in every space; the plan had that only in + the diary, and folders first then by name elsewhere. +- `Ctrl-P` is full-text search across every space; the plan had it become a + jump to a node by its name and path, with `Tab` in `/` reaching every space. +- A card's notes are made in the space's root, not in the folder being + browsed. +- `o` does not offer the space's templates; `:new