forked from heavy-duty/ceremony
docs: delete LABELS.md's scope table — the per-repo set lives in labels.conf and CONTRIBUTING
The mirror is byte-identical in every governed repo, so the four-row enumeration was true at home and false in rig, box, cast and incubator — 14 of 16 vendored rows lied. The section keeps its doctrine and points at the two places true wherever the reader stands; ceremony's own set is now a pointer sentence in CONTRIBUTING, and a labels.test.sh row (red on main, 4 hits) keeps enumeration from returning. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
parent
d4e133bc1f
commit
ee0aab1c69
4 changed files with 21 additions and 10 deletions
|
|
@ -8,6 +8,7 @@ so entries say what changed, cite the issue, and stop.
|
||||||
|
|
||||||
- BUILDER.md — the handed-off PR is the parked claim's fourth shape, its handoff is its declaration, and shape 2 covers the round awaiting its first verdicts (#109).
|
- BUILDER.md — the handed-off PR is the parked claim's fourth shape, its handoff is its declaration, and shape 2 covers the round awaiting its first verdicts (#109).
|
||||||
- `labels-reconcile` — a degraded mergeability/checks read now logs gh's actual stderr (collapsed, bounded) beside the byte-identical counted line, and the blind-sweep warning leads with the observed reason instead of asserting the permissions cause (#101).
|
- `labels-reconcile` — a degraded mergeability/checks read now logs gh's actual stderr (collapsed, bounded) beside the byte-identical counted line, and the blind-sweep warning leads with the observed reason instead of asserting the permissions cause (#101).
|
||||||
|
- `LABELS.md` — drop the vendored scope-table enumeration; the per-repo set lives in `.github/labels.conf` and the repo's own CONTRIBUTING (#104).
|
||||||
- Changelog publication — count entries instead of bytes, refuse dangling grouped headings, and seed grouped re-arms with Added/Changed/Fixed (#98).
|
- Changelog publication — count entries instead of bytes, refuse dangling grouped headings, and seed grouped re-arms with Added/Changed/Fixed (#98).
|
||||||
- `labels-reconcile` — grant callers private-repo check reads and warn when an entire PR sweep is blind (#95).
|
- `labels-reconcile` — grant callers private-repo check reads and warn when an entire PR sweep is blind (#95).
|
||||||
- `labels-reconcile` — the bootstrap now retires the six GitHub defaults `LABELS.md` publishes as deleted, tolerating both an already-absent label and a refused delete (#93).
|
- `labels-reconcile` — the bootstrap now retires the six GitHub defaults `LABELS.md` publishes as deleted, tolerating both an already-absent label and a refused delete (#93).
|
||||||
|
|
|
||||||
|
|
@ -86,7 +86,11 @@ roster is config, not doctrine — swapping a vendor is an edit to this table
|
||||||
(and to `panel=` in `.github/labels.conf` once #10 lands), nothing more.
|
(and to `panel=` in `.github/labels.conf` once #10 lands), nothing more.
|
||||||
|
|
||||||
Each governed repo names its own roster in its CONTRIBUTING; this one is
|
Each governed repo names its own roster in its CONTRIBUTING; this one is
|
||||||
ceremony's.
|
ceremony's. Its `scope:*` set is the same kind of repo-specific fact:
|
||||||
|
ceremony's scopes are defined in [`.github/labels.conf`](.github/labels.conf)
|
||||||
|
— one `name|color|description` row each, with PR path mapping in
|
||||||
|
[`.github/labeler.yml`](.github/labeler.yml). The conf is the set; no prose
|
||||||
|
table repeats it (#104).
|
||||||
|
|
||||||
## Code conventions
|
## Code conventions
|
||||||
|
|
||||||
|
|
|
||||||
16
LABELS.md
16
LABELS.md
|
|
@ -170,15 +170,13 @@ re-arms mentions, but only the writer can declare that a move is owed (#83).
|
||||||
## Scope — which surface? (PRs and issues, any number)
|
## Scope — which surface? (PRs and issues, any number)
|
||||||
|
|
||||||
All scopes share one calm color, `#C5DEF5` — scopes locate, states alert. The
|
All scopes share one calm color, `#C5DEF5` — scopes locate, states alert. The
|
||||||
set is per-repo (`.github/labels.conf`); PRs get theirs from changed paths via
|
set is per-repo: PRs get theirs from changed paths via actions/labeler, issues
|
||||||
actions/labeler, issues get theirs from triage. This repo's set:
|
get theirs from triage. This file never enumerates a set — it is mirrored
|
||||||
|
byte-identically into every governed repo, and any list it carried would be
|
||||||
| Label | Covers |
|
true in one repo and false in the rest (#104). The set for the repo you are
|
||||||
|---|---|
|
standing in lives in the two places that are true wherever you read them: its
|
||||||
| `scope:release-flow` | the reusable release workflow, decide, the doors |
|
`.github/labels.conf` (the definitions, one `name|color|description` row per
|
||||||
| `scope:guards` | changelog-armed / changelog-monotonic / drill-recorded |
|
scope) and its own `CONTRIBUTING.md`, beside the other repo-specific facts.
|
||||||
| `scope:labels` | the labels workflow, reconciler, this taxonomy |
|
|
||||||
| `scope:docs` | README doctrine, CONSUMERS.md, the role files |
|
|
||||||
|
|
||||||
## Issue types
|
## Issue types
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -53,4 +53,12 @@ load_config "$TMP/good.conf"
|
||||||
set_required_bots two
|
set_required_bots two
|
||||||
check "PR author is recused from the required panel" 0 "one three" printf '%s\n' "${REQUIRED_BOTS[*]}"
|
check "PR author is recused from the required panel" 0 "one three" printf '%s\n' "${REQUIRED_BOTS[*]}"
|
||||||
|
|
||||||
|
# LABELS.md is mirrored byte-identically into every governed repo, so any
|
||||||
|
# scope enumeration it carries is true at home and false everywhere else —
|
||||||
|
# 14 of 16 vendored rows were false across the family when this fired (#104).
|
||||||
|
# The set lives in labels.conf and the repo's CONTRIBUTING; the mirror never
|
||||||
|
# names it. grep -c prints the count and exits 1 when that count is 0.
|
||||||
|
check "LABELS.md enumerates no repo's scope labels" 1 "0" \
|
||||||
|
grep -c 'scope:release-flow\|scope:guards\|scope:labels\|scope:docs' "$ROOT/LABELS.md"
|
||||||
|
|
||||||
summary
|
summary
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue