docs: route vendored doctrine through the manifest
Some checks failed
labels / labels (pull_request) Failing after 17s
CI / test (pull_request) Has been cancelled
CI / release-exercise (pull_request) Has been cancelled
CI / self-guards (pull_request) Has been cancelled
CI / action-exercise (pull_request) Has been cancelled
CI / docs-sync-exercise (pull_request) Has been cancelled
Refs guard / refs-not-closing (pull_request) Has been cancelled
Some checks failed
labels / labels (pull_request) Failing after 17s
CI / test (pull_request) Has been cancelled
CI / release-exercise (pull_request) Has been cancelled
CI / self-guards (pull_request) Has been cancelled
CI / action-exercise (pull_request) Has been cancelled
CI / docs-sync-exercise (pull_request) Has been cancelled
Refs guard / refs-not-closing (pull_request) Has been cancelled
This commit is contained in:
parent
c2ef6a2fc2
commit
d12cc3d84f
2 changed files with 14 additions and 23 deletions
|
|
@ -97,14 +97,13 @@ table repeats it (#104).
|
||||||
|
|
||||||
## Doctrine conventions
|
## Doctrine conventions
|
||||||
|
|
||||||
The vendored role files — `AGENTS.md`, `TRIAGE.md`, `BUILDER.md`,
|
The vendored role files — the set [`docs/VENDORED.txt`](docs/VENDORED.txt)
|
||||||
`REVIEWER.md`, `LABELS.md`, and `RELEASES.md` — state each normative rule
|
declares — state each normative rule completely, keep at most one sentence of
|
||||||
completely, keep at most one sentence of why, and cite its record only with a
|
why, and cite its record only with a bare parenthetical such as `(#N)`,
|
||||||
bare parenthetical such as `(#N)`, `(#N D3)`, or `(#N, #M)`. Incident
|
`(#N D3)`, or `(#N, #M)`. Incident narrative — timestamps, actors, quoted
|
||||||
narrative — timestamps, actors, quoted comments, measured counts, and links to
|
comments, measured counts, and links to specific comments — belongs in that
|
||||||
specific comments — belongs in that record. If a rule cannot be followed
|
record. If a rule cannot be followed without chasing its cite, the rule is
|
||||||
without chasing its cite, the rule is under-stated: fix the statement, not the
|
under-stated: fix the statement, not the citation. (#280)
|
||||||
citation. (#280)
|
|
||||||
|
|
||||||
Normative text in those files does not cite issues from other repositories.
|
Normative text in those files does not cite issues from other repositories.
|
||||||
Consumers read the vendored bytes outside this organization's context, and a
|
Consumers read the vendored bytes outside this organization's context, and a
|
||||||
|
|
@ -119,21 +118,12 @@ every session. (#280)
|
||||||
|
|
||||||
## How the other repos use this
|
## How the other repos use this
|
||||||
|
|
||||||
Two consumption modes, split by what has a runtime:
|
Two consumption modes, split by what has a runtime: **machinery by
|
||||||
|
reference**, fetched at run time from the ref a caller pins, and **doctrine
|
||||||
- **Machinery is consumed by reference.** Workflows and actions are fetched
|
as a mirror** — the set [`docs/VENDORED.txt`](docs/VENDORED.txt) declares,
|
||||||
by GitHub at run time from the ref the caller pins — no copy exists in the
|
vendored at `.ceremony/` and held to the pin by a guard (issue #19). The
|
||||||
consumer.
|
[README](README.md) states both modes in full, and why they differ; what
|
||||||
- **Doctrine is consumed as a machine-verified mirror.** A document's only
|
follows is only what they leave a governed repo to carry.
|
||||||
"runtime" is an agent reading the working tree of the repo it stands in —
|
|
||||||
a doc that requires a cross-repo fetch before it governs is a doc that
|
|
||||||
sometimes goes unread. So the agent-facing set — **AGENTS.md, TRIAGE.md,
|
|
||||||
BUILDER.md, REVIEWER.md, LABELS.md, RELEASES.md** — is vendored into each governed
|
|
||||||
repo at **`.ceremony/`**, byte-identical to this repo at the pinned ref,
|
|
||||||
by the sync tool (issue #19). A CI guard diffs the mirror against the pin
|
|
||||||
on every PR: hand-editing a vendored file, or bumping the pin without
|
|
||||||
re-syncing, goes red. It is a copy that cannot drift — which is the only
|
|
||||||
kind of copy this org allows.
|
|
||||||
|
|
||||||
A governed repo (box, rig, cast, incubator, …) therefore carries:
|
A governed repo (box, rig, cast, incubator, …) therefore carries:
|
||||||
|
|
||||||
|
|
|
||||||
1
changelog.d/229.md
Normal file
1
changelog.d/229.md
Normal file
|
|
@ -0,0 +1 @@
|
||||||
|
- Forge consumers now receive the upstream 0.6.1 and 0.6.2 doctrine for vendored-set routing, review-round signalling, operator-owned remainders, producer liveness, and post-merge release edges (#229).
|
||||||
Loading…
Reference in a new issue