Merge branch 'worktree-docs-overhaul-a-standard' into worktree-docs-overhaul-b-agents
# Conflicts: # docs/AGENTS.md # docs/rfc/implemented/process/2026-07-04-doc-tiers-and-budgets.md # scripts/doc-budgets.manifest.json
This commit is contained in:
@@ -40,7 +40,7 @@ Compression discipline: every load-bearing rule survives — as one to three lin
|
||||
|
||||
1. Relocate: does the new content belong in a linked home (RFC, postmortem, cookbook, README) with a one-line pointer left behind?
|
||||
2. Condense: can existing prose in the doc pay for the addition — a story compressed to its rule, a duplicate converted to a link?
|
||||
3. Only then raise the ceiling: edit `scripts/doc-budgets.manifest.json` and justify the raise explicitly in the PR description. After any rewrite that shrinks a budgeted doc, ratchet its ceiling down to the new size plus modest headroom in the same PR.
|
||||
3. Only then raise the ceiling: edit `scripts/doc-budgets.manifest.json` and justify the raise explicitly in the PR description. After any rewrite that shrinks a budgeted doc, ratchet its ceiling down to the new size plus working headroom (at least 5%) in the same PR.
|
||||
|
||||
## Validation and PR hygiene
|
||||
|
||||
|
||||
Reference in New Issue
Block a user