Skip to content

Cut the 1.5.0 notes to three entries and draw the restart - #124

Merged
marcosqlbi merged 2 commits into
mainfrom
docs/trim-1-5-0-notes
Sep 11, 2026
Merged

marcosqlbi merged 2 commits into
mainfrom
docs/trim-1-5-0-notes

Conversation

@marcosqlbi

Copy link
Copy Markdown
Collaborator

The 1.5.0 notes went in at five entries where 1.4.0 has two and 1.3.1 has three, several of
them four and five lines. CONTRIBUTING asks for one heading per thing a person notices, two
to four lines each, and says the test is the neighbours — these were noticeably longer than
the ones beside them. That file records this having been asked for twice; this is the third.

The notes

Three entries: the board comes back, closing asks first, work survives a crash.

Two of the five were not separate things a person notices. Being offered your changes when
you reopen the board is the same story as being offered them at startup, so it folds into
the crash entry as a clause. The title bar naming the board is how you see that it has
unsaved changes, so it folds into the closing entry, which is where you meet it.

Lengths are now 3, 4 and 3 lines, against 1.4.0's 4 and 3.

The guide

Pick up where you left off was the only section in its run without a figure, so it gains
one: the same board before and after a restart, with the same ink in the same place and the
same unsaved marker in the title. Two panels and an arrow — the point being that nothing
changed across the restart, so the two halves are the same drawing, emitted once in defs
and placed twice.

It is drawn from the --fig-* variables rather than fixed colors, and carries the same faint
canvas grid the other figures use. Checked in both light and dark.

The prose also picks up the case it was missing — reopening a board offers what a crash left
for it — and loses a sentence in the process.

No code changes; VersionPrefix is untouched at 1.5.0.

🤖 Generated with Claude Code

marcosqlbi and others added 2 commits September 11, 2026 19:18
The 1.5.0 notes had five entries where 1.4.0 has two and 1.3.1 has
three, several of them four and five lines. CONTRIBUTING asks for one
heading per thing a person notices, two to four lines each, and says the
test is the neighbours. These were noticeably longer than the ones beside
them, which is the third time this has been asked for.

Three entries now: the board comes back, closing asks first, and work
survives a crash. Recovering when you reopen the board folds into the
crash entry rather than standing alone, and the title bar folds into the
closing entry, which is where a person meets it.

The guide's section gains the figure the sections around it have: the
same board before and after a restart, same ink in the same place, drawn
from the theme variables so it works in both light and dark. Its prose
also picks up the case that was missing, where reopening a board offers
what a crash left for it.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The count was two. Naming the failure mode rather than only the rule is
what might stop a fourth: entries get written one per piece of work that
was built, rather than one per thing a person notices.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@marcosqlbi
marcosqlbi merged commit 0cfad09 into main Sep 11, 2026
5 checks passed
@marcosqlbi
marcosqlbi deleted the docs/trim-1-5-0-notes branch September 11, 2026 17:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant