Skip to content

docs(sign): document signature placement and field selection - #123

Open
samuelsl27 wants to merge 1 commit into
Stirling-Tools:mainfrom
samuelsl27:docs/signature-placement
Open

docs(sign): document signature placement and field selection#123
samuelsl27 wants to merge 1 commit into
Stirling-Tools:mainfrom
samuelsl27:docs/signature-placement

Conversation

@samuelsl27

Copy link
Copy Markdown

Documents the signature changes proposed in Stirling-Tools/Stirling-PDF#7262.

The visible-signature section currently reads:

Visible: Appears as a box on a chosen page showing the signer name, signing date, and reason, with an optional logo.

That is now incomplete on three counts. The box can be placed anywhere on the page rather than only on a chosen page, its contents are picked from fourteen certificate fields rather than three fixed ones, and it can optionally be repeated across every page.

Three subsections added:

  • Placing the Signature — drawing the box on the document, both gestures, and that the drawn-on page becomes the signed page.
  • Choosing What the Box Shows — the available fields, and that absent ones are skipped rather than drawn blank.
  • Repeating It on Every Page — behind a :::caution, because the honest version is easy to miss: only the drawn-on page is really signed, and the marks on the other pages are not signatures. Readers should learn that here rather than discovering it later.

Timing: the code PR is still under review, so this may need adjusting if the approach changes there — in particular the every-page option, which is the part most likely to be dropped. Happy to hold this until #7262 settles, or to amend it alongside any changes requested there.

The visible-signature section said the box "appears on a chosen page showing the
signer name, signing date, and reason", which is now incomplete on three counts:
the box can be placed anywhere on the page, its contents are chosen from
fourteen certificate fields, and it can be repeated across every page.

Documents the every-page option with a caution rather than a plain description,
because the honest version of it is easy to miss: only the drawn-on page is
really signed and the rest carry a mark that no validator will report. Readers
finding that out from the document rather than from the UI is the wrong way
round.

Accompanies Stirling-Tools/Stirling-PDF#7262.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Aug 3, 2026

Copy link
Copy Markdown

@samuelsl27 is attempting to deploy a commit to the Stirling-PDF Team on Vercel.

A member of the Team first needs to authorize it.

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