aboutsummaryrefslogtreecommitdiff
path: root/review-code
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-05-29 20:21:02 -0500
committerCraig Jennings <c@cjennings.net>2026-05-29 20:21:02 -0500
commitbd2d96c948137ebddd97ee3033d89ac52437b043 (patch)
tree4f4f40697d71f7da65f9feb2f40d71d9145088e8 /review-code
parent8424e8ff33fd397483bf695b56ae229575f0c067 (diff)
downloadrulesets-bd2d96c948137ebddd97ee3033d89ac52437b043.tar.gz
rulesets-bd2d96c948137ebddd97ee3033d89ac52437b043.zip
docs(cross-project-broadcast): codify capability-and-rule cadence guideline
Adds one bullet to When NOT to Use and a new Cadence Guideline section that names the per-commit-broadcast anti-pattern explicitly. The new section lays out the five reasons broadcasts stay capability-and-rule-level rather than commit-level: cost per broadcast across the fleet, signal-to-noise on project-internal commits, the rsync-already-does-the-work observation, aggregation winning over per-commit pings, and the train-projects-to-ignore-inbox risk. The end-of-session bundling guidance lands too. If a session ships several broadcastable changes, bundle them into one broadcast at session end instead of firing one per commit. Source: session-end conversation 2026-05-29 surveying today's cross-project changes. Today's session shipped 13 cross-project items (4 new workflows, 6 workflow updates, 2 new scripts, 1 new bin tool). A per-commit broadcast cadence would have fired 13 inbox files across 23 targets, or 299 total inbox files. One consolidated broadcast (or no broadcast at all, since Craig already coordinated manually) covered the same ground.
Diffstat (limited to 'review-code')
0 files changed, 0 insertions, 0 deletions