Skip to content

docs(workbench): replacing the words, and what keeps the line still - #48

Merged
tannevaled merged 1 commit into
mainfrom
docs/replace-the-words
Nov 8, 2026
Merged

tannevaled merged 1 commit into
mainfrom
docs/replace-the-words

Conversation

@tannevaled

Copy link
Copy Markdown
Contributor

A section for Replace the words (app#92), written around the two things a reader needs to know before pressing it.

The promise: the rest of the line stays where it was — a shorter replacement does not pull the following text left, a longer one does not push it right.

The limit, in the reader's terms rather than the format's: a PDF holds drawing operations, not words, and a page may make each one a line, a word or a single letter. So documents from a word processor replace cleanly, documents from a typesetter are refused with a count, and the page says which is which instead of leaving somebody to guess why a verb appeared to do nothing.

⛔ And the warning that belongs to this verb alone: it is the only one that changes what the document says. A mark comes off, a comment comes off, a redaction announces itself — this puts words in the author's mouth, so the status line names both the old and the new.

🤖 Generated with Claude Code

A section for Replace the words, written around the two things a reader needs
to know before pressing it.

The first is the promise: the rest of the line stays where it was, so a shorter
replacement does not pull the following text left.

The second is the limit, in the reader's terms rather than the format's. A PDF
holds drawing operations, not words, and a page may make each one a line, a
word or a single letter -- so documents from a word processor replace cleanly
and documents from a typesetter are refused with a count. The page says which
is which instead of leaving somebody to guess why a verb did nothing.

And the warning that belongs on this one alone: it is the only verb that
changes what the document SAYS, so the status line names the old words and the
new ones.

Covers go-pdfkit/app#92.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@tannevaled
tannevaled merged commit 0f3a667 into main Nov 8, 2026
2 checks passed
@tannevaled
tannevaled deleted the docs/replace-the-words branch November 8, 2026 13: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