From 416ad066eff15cb90bb0b14e469bdc9d4b839c05 Mon Sep 17 00:00:00 2001 From: tannevaled Date: Mon, 9 Nov 2026 14:13:57 +0100 Subject: [PATCH] docs: a fillable field for the words you selected, and several files at once app v0.48.0 reaches ops.AddFields from the ribbon for the first time -- it was `pdfops addfields` or nothing -- with the gesture the question asks for: a blank printed form is a page of questions, so selecting one names the field and places it under those words. app v0.49.0 merges as many files as you choose, in the order you chose them, through a second file input carrying `multiple`; the shared one stays single because every other verb that asks for a file wants exactly one. Covers go-pdfkit/app#103 and go-pdfkit/app#104. Co-Authored-By: Claude Opus 5 --- content/working-with-a-file/workbench.md | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/content/working-with-a-file/workbench.md b/content/working-with-a-file/workbench.md index c735cd8..78690a1 100644 --- a/content/working-with-a-file/workbench.md +++ b/content/working-with-a-file/workbench.md @@ -102,8 +102,24 @@ entries that point nowhere and anything past the thousand it reads. The last three are the ones worth telling apart. **Read** is where you look at what a page says — read it, search it, copy it — and nothing on it changes the document. **Mark up** is where you act on the words you selected: mark them, -draw on them, comment on them, or alter them. **Hand over** is where you ask for -a copy of the document in some other form. +draw on them, comment on them, alter them, or **make a fillable field for +them**. **Hand over** is where you ask for a copy of the document in some other +form. + +*Make a field for this* turns a printed form into one somebody can fill in. A +blank form is a page of **questions** — *Surname*, *Date of birth* — so selecting +the question names the field and places it under those words in one gesture: a +box to type in, or a tick. The name is the words without their punctuation, +because a field's name travels outside the document, into exported data and into +whatever script fills the form. The placement is **checked** against the paper +rather than clamped onto it — under the words, or above them for a question on +the last line — and a tick is a square. + +*Add files after this one* takes as many as you choose, in the order you chose +them, through a second file input carrying `multiple`. The one every other verb +shares stays single on purpose: they all want exactly one file, and a picker +allowing several would hand back a list the code took the first of in silence. A +file among them that cannot be read stops the merge and says which. That one sentence decides where every control goes. *Turn them* is a verb and sits on the ribbon; *a quarter / a half / three quarters* is what it is told