docs: call an authority Evidence deployment a gateway - #38
Merged
Conversation
"Cell" was a coinage of the authority-owned reset that no visitor-facing surface ever defined. Registry Stack itself calls the service that answers a requirement over an authority's own source an Evidence gateway, so the lab now uses that noun everywhere a reader sees it: the Visitor Center copy, the published DCAT titles, the docs, and the README. Identities keep their existing spelling. Directory names, hostnames, volume paths, the `solmara-authority-cells` catalogue id, and the `SOLMARA_<CELL>_EVIDENCE_PUBLIC_HOST` variables are addresses rather than descriptions, and renaming them would move deployed routes and break anyone who has harvested the catalogue. The purposes parser gained a test for the three-column row, the only shape the published catalogue actually has, because the previous suite covered only the five-column fixture and so never exercised the hardcoded enforcing-service string this rename touches. Signed-off-by: Jeremi Joslin <jeremi@joslin.fr>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
cellwas a private coinage of the authority-owned reset. It is definednowhere a reader can find, it collides with the local
evidence-gatewayCaddy service in
compose.yaml, and upstream Registry Stack never uses itas a product term: its noun for the service that answers a requirement over
an authority's own source is Evidence gateway (165 occurrences in the
registry-stack docs).
What changed
Every surface a reader sees now says "authority Evidence gateway":
services.tslabels and blurbs,ProofStrip,SolmaraPreview, the anatomy page and its meta descriptionpurposes.tsenforcing-service string, plus the publisheddocs/purposes.mdcataloguedocs/solmara.md,docs/hosted-deployment.md, both story docs,README.mddata_servicestitles, withmetadata/public/regeneratedA dated changelog entry records the wording change and its limits.
What deliberately did not change
Identities are addresses, not descriptions, so renaming them would move
deployed routes or break a harvester:
evidence/cells/,runtime/evidence-cells/,config/evidence/local/cells/*-authority-cells.solmara.registrystack.orghosts and/data/solmara-authority-cells/...volume pathsmetadataid: solmara-authority-cellsSOLMARA_<CELL>_EVIDENCE_PUBLIC_HOSTvariablesevidence/scripts/build-cells.pyandevidence/tests/test_cells.pyThe
evidence-gatewayCaddy service incompose.yaml(local TLS front door,11 references across 6 files) is untouched. The README entry point is now
described as "Local TLS front door" so the two no longer read as the same
thing, but whether that service should also be renamed is a separate call.
Verification
just lintgreen (ruff, fiction, config secrets, image pins, runtimetopology, release pin, signer keys, metadata publish
--check,metadata-lint, portal
pnpm check, homepnpm check)just testgreen: 302 Python tests, 143 portal, 62 homeTDD note
Updating the
purposes.test.tsassertions alone stayed green, because thefixture's five-column rows read
enforcedByfrom the table while the realcatalogue's three-column rows take the hardcoded branch. A new test covering
the three-column row went red first, then green.