Skip to content

docs(release): document the release signing key and publish it - #23

Merged
vmvarela merged 1 commit into
masterfrom
docs/6-release-signing-key
Oct 23, 2026
Merged

vmvarela merged 1 commit into
masterfrom
docs/6-release-signing-key

Conversation

@vmvarela

Copy link
Copy Markdown
Owner

What

Adds a Signing key section to docs/guides/releases.md and publishes the release key's public half as docs/guides/signing-key.asc.

Why

Blocker 1 of #6: no signing identity existed, so the first release could never be produced. This records the dedicated key, its fingerprint and expiry, the custody rules for the private material, the three repository secrets the release workflow already reads, and the verification a consumer can run. Only the public key enters the repository.

Refs #6

How tested

  • make docs: no generated drift; the guide tree is hand-written.
  • git diff --check: clean.
  • Emulated the release path: imported the armor with the trailing newline stripped (the shape a repository secret takes), signed with --pinentry-mode loopback --passphrase-file --local-user <fingerprint>, then verified in a keyring holding only the public key. Result: Good signature, binary detached signature, primary key 3610 065D B825 0D31 A49E C0D5 2845 88A6 1CDA 90B9.
  • gh secret list confirms GPG_PRIVATE_KEY, GPG_PASSPHRASE and GPG_FINGERPRINT are set.

Remaining work

Blocker 1 of #6 was that no signing identity existed. Record the dedicated
release key, its fingerprint and expiry, the custody rules for the private
material, the three repository secrets the release workflow reads, and the
verification a consumer can run against the published public key.
@vmvarela
vmvarela merged commit cb50a3f into master Oct 23, 2026
3 checks passed
@vmvarela
vmvarela deleted the docs/6-release-signing-key branch October 23, 2026 08:39
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