Skip to content

docs(sign): document signature placement, field selection and the custom logo - #123

Open
samuelsl27 wants to merge 3 commits into
Stirling-Tools:mainfrom
samuelsl27:docs/signature-placement
Open

docs(sign): document signature placement, field selection and the custom logo#123
samuelsl27 wants to merge 3 commits 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.

Covers the PNG/JPEG upload, the five positions, and the two rules that keep the result usable: the image keeps its proportions, and the details keep a usable share of the box whatever shape the logo is.
@samuelsl27 samuelsl27 changed the title docs(sign): document signature placement and field selection docs(sign): document signature placement, field selection and the custom logo Aug 15, 2026
The page said the option works on every edition but not what happens when the desktop is connected to a self-hosted server, which is where it used to disappear.
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