Skip to content

docs: fix contradictions in product count, Coordinator status, jwt-vc-issuer and Render seal keys - #2636

Merged
jeremi merged 6 commits into
mainfrom
docs/fix-contradictions-20261110
Nov 12, 2026
Merged

jeremi merged 6 commits into
mainfrom
docs/fix-contradictions-20261110

Conversation

@jeremi

@jeremi jeremi commented Nov 10, 2026 •

Copy link
Copy Markdown
Member

Summary

Docs consistency fixes found while reviewing the docs, plus a startup fix in the reviewed-notice tutorial helper.

  1. README product count: it said seven installable products but its own example table and the release roster list ten (Evidence, BReg, Casework, Scheduling, Messaging, Render, Discovery, Manifest, Coordinator, Adapter). The Document Store is held out (DOCUMENTS_FIRST_RELEASE = None). Added the missing Render, Coordinator and Adapter entries.
  2. Coordinator status: several pages said its binaries and clients were unreleased or the product "experimental". Release packaging ships the binaries, installer and client namespace from v0.44.0 (COORDINATOR_BINARY_FIRST_RELEASE, COORDINATOR_CLIENT_FIRST_RELEASE); only the image is held (COORDINATOR_FIRST_RELEASE = None).
  3. /.well-known/jwt-vc-issuer: SECURITY.md and the vulnerability-reporting page listed it as a missing endpoint. Evidence serves it (JWT_VC_ISSUER_ROUTE in crates/registry-evidence/src/server.rs).
  4. Render seal custody. Production seals use Vault or OpenBao Transit. The page explains the key metadata Render checks at startup, the operator’s responsibility for storage custody, and the local JWK used by test seals.
  5. Installation guidance uses the selected release tag and points to the published assets for platform and installer availability.
  6. The reviewed-notice tutorial uses matching release artifacts and reads the Messaging image digest from the verified manifest. The session helper passes the BReg owner project when starting Coordinator.

Evidence

  • The 949 docs tests and production-shaped docs build passed. Evidence anchors, Markdown, Vale, and the Coordinator tutorial dry run passed after the final wording edits.
  • All 71 Coordinator script tests passed. The new startup regression failed before the helper fix.
  • The published v0.46.0 installer installed both Coordinator binaries on macOS arm64. The tutorial completed with unmodified v0.45.0 artifacts and with v0.46.0 artifacts plus the corrected helper in a local copy of its source archive. Both runs restarted Coordinator, recorded one approval email in Mailpit, and cleaned up their sessions.

Notes

release/units.yaml governs independent product releases. The Stack release roster governs the artifacts that ship on Stack tags. The published v0.46.0 source archive contains the original session helper, and the tutorial records its startup limitation.

DCO

  • Every commit includes a Signed-off-by trailer.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 10, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-12T06:56:25.086655Z 0a7fa24 New commits
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

…e roster

Signed-off-by: Jeremi Joslin <jeremi@joslin.fr>
…ly the image is held

Signed-off-by: Jeremi Joslin <jeremi@joslin.fr>
…Evidence serves it

Signed-off-by: Jeremi Joslin <jeremi@joslin.fr>
…Transit

Signed-off-by: Jeremi Joslin <jeremi@joslin.fr>
Signed-off-by: Jeremi Joslin <jeremi@joslin.fr>
Signed-off-by: Jeremi Joslin <jeremi@joslin.fr>
@jeremi
jeremi force-pushed the docs/fix-contradictions-20261110 branch from 7f536e1 to 0a7fa24 Compare November 12, 2026 06:55
@jeremi
jeremi added this pull request to the merge queue Nov 12, 2026
@github-merge-queue
github-merge-queue Bot removed this pull request from the merge queue due to failed status checks Nov 12, 2026
@jeremi
jeremi added this pull request to the merge queue Nov 12, 2026
Merged via the queue into main with commit 2352e22 Nov 12, 2026
58 checks passed
@jeremi
jeremi deleted the docs/fix-contradictions-20261110 branch November 12, 2026 09:15
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