Skip to content

docs(runbooks): clarify deprecation review signals#442

Merged
ss-o merged 1 commit into
mainfrom
docs/deprecation-stability-signals
Jun 12, 2026
Merged

docs(runbooks): clarify deprecation review signals#442
ss-o merged 1 commit into
mainfrom
docs/deprecation-stability-signals

Conversation

@ss-o

@ss-o ss-o commented Jun 12, 2026

Copy link
Copy Markdown
Member

Summary

  • Clarifies that quiet or stable repositories are not abandoned by default.
  • Requires deprecation review to consider maintainer intent, consumer usage, and replacement availability instead of age or issue volume alone.
  • Keeps the existing migration-first sunset flow intact.

Verification

  • git diff --check
  • ruby -e 'require "yaml"; Dir["workflow-templates/*.yml", ".github/workflows/*.yml", ".github/ISSUE_TEMPLATE/*.yml"].sort.each { |f| YAML.load_file(f); puts f }'
  • ruby -e 'abort "missing stability policy" unless File.read("runbooks/deprecation.md").include?("Quiet repositories are not abandoned by default")'

Closes #415

Copilot AI review requested due to automatic review settings June 12, 2026 09:03
@ss-o ss-o requested a review from a team as a code owner June 12, 2026 09:03

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the deprecation/sunset runbook to clarify that low-activity (“quiet”) repositories are not presumed abandoned, and that deprecation review should weigh maintainer intent, consumer usage, and replacement availability rather than age or issue volume alone.

Changes:

  • Adds explicit guidance that stable/quiet repos trigger review, not automatic deprecation/archival.
  • Expands “Step 1 — Decide and record” to require documenting stability intent vs. true unmaintenance, plus replacement availability.
  • Keeps the existing migration-first sunset flow intact while refining the decision signals.

Comment thread runbooks/deprecation.md Outdated
@ss-o ss-o enabled auto-merge (squash) June 12, 2026 09:05
@ss-o ss-o force-pushed the docs/deprecation-stability-signals branch from 9913392 to ec3a6c9 Compare June 12, 2026 09:06
@ss-o ss-o merged commit 47849c5 into main Jun 12, 2026
4 checks passed
@ss-o ss-o deleted the docs/deprecation-stability-signals branch June 12, 2026 09:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add repository deprecation runbook

2 participants