Skip to content

chore(issues): record blockers as GitHub issue dependencies, not a label - #684

Merged
Medformatik merged 1 commit into
mainfrom
chore/drop-blocked-label
Oct 30, 2026
Merged

Medformatik merged 1 commit into
mainfrom
chore/drop-blocked-label

Conversation

@Medformatik

Copy link
Copy Markdown
Collaborator

What changed and why

Blocked issues were tracked twice: with GitHub's own "blocked by" relation and with a blocked label that had to match it by hand. The two had drifted. Three issues had open blockers linked but no label, and three others were still linked only to closed blockers. The native relation already names the blocking issue, stops counting once that issue closes, and is searchable with is:blocked. Right now is:blocked and label:blocked return the same six issues.

This PR drops the label:

  • .github/labels.json no longer defines blocked.
  • The issue-lifecycle workflow cleans up only needs-triage and needs-info when an issue closes.
  • The contributing process doc removes the label and says to record a prerequisite as a "blocked by" relation. A prerequisite outside GitHub gets its own tracking issue so it can be linked.

After merge, the label itself will be deleted from the repository; until then the monthly drift report would list it as unknown.

Verification

  • scripts/issue-lifecycle.test.ts: 30 tests pass. The fixtures now use integration where blocked stood in as a second label.
  • Prettier and Biome pass on the changed files.

Release and upgrade impact

Product impact: ordinary

GitHub's native "blocked by" relation names the blocking issue, clears when
it closes and is searchable with is:blocked. The blocked label duplicated it
and had to be kept in sync by hand. Drop it from the label definitions and the
lifecycle cleanup, and document the native relation instead.
@Medformatik Medformatik added documentation Documentation content, tooling or workspace dependencies ci Continuous integration and GitHub Actions changes labels Oct 30, 2026
@Medformatik Medformatik self-assigned this Oct 30, 2026
@Medformatik
Medformatik merged commit bf551c6 into main Oct 30, 2026
24 checks passed
@Medformatik
Medformatik deleted the chore/drop-blocked-label branch October 30, 2026 07:34
@github-actions github-actions Bot locked and limited conversation to collaborators Oct 30, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

ci Continuous integration and GitHub Actions changes documentation Documentation content, tooling or workspace dependencies

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant