Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Self-attested maintenance status via MAINTAINERS.md + annual ping (organizational projects)

Aperta
#210 1 commento 0 reazioni 1 assegnatario Vedi su GitHub

@jepfp ci sta già lavorando.

Dal 18/9/2026.

Valutazione

Questa issue non è ancora stata valutata.

Descrizione

User Story

As a user evaluating whether to adopt a Typelevel library, I want each project's maintenance status to be self-declared by its maintainers and periodically reconfirmed, so that I don't have to guess from raw git activity whether a quiet project is stable or abandoned.

Approach (deliberately lightweight)

No central score, no dashboard, no TSC judgment call on individual project health. Two ingredients only:

  1. MAINTAINERS.md on every Organization/Affiliate project: who is committed, and when that was last confirmed.
  2. A regular ping: a bot or TSC member opens an issue asking current maintainers "are you still committed?". A confirmation just updates the date in MAINTAINERS.md — nothing else happens. "Yes, but I'm busy" is a complete and sufficient answer.

If the ping goes fully unanswered after the agreed number of reminders, the project is handed to the fallback process defined in the linked deprecation-process ticket. That hand-off is the only consequence defined here — this ticket does not decide what happens next.

Why not a score/dashboard

  • A centralized score (e.g. commit/release frequency) is already known to be noisy in this org: scala-steward's automated commits make "last update" meaningless as a raw signal.
  • It would misjudge stable-but-quiet projects as dead (the Spire case raised in the original discussion) — activity level doesn't distinguish "abandoned" from "finished."
  • A public low "health" score is discouraging to volunteers and risks being self-fulfilling.
  • Building and maintaining scoring infrastructure competes for the same scarce volunteer time this whole effort is trying to protect.
  • The raw signals (last commit, last release) are already public on GitHub; what's missing isn't more data, it's a current confirmation from the person who actually knows.

Acceptance Criteria

  • A document describing the MAINTAINERS File Requirements is defined (similar to https://lf-decentralized-trust.github.io/governance/governing-documents/MAINTAINERS-file/)
  • A minimal MAINTAINERS.md example is defined (maintainer(s), last confirmed date, how to reach them).
    • A solution has found to not introduce an additional duplication (beside the GH teams and publisher settings) (see feedback in comment)
  • An annual ping mechanism is defined: what triggers it, how many reminders, over what time window, and where it posts (e.g. an issue on the project itself).
  • The escalation point is defined: after N unanswered reminders, the project is handed off to the fallback process (linked ticket).
  • No score, dashboard, or TSC judgment on individual project quality is introduced as part of this ticket.
  • Rolled out to all current Organization and Affiliate projects.

Non-Goals

  • Any scoring/dashboard mechanism (rejected, see above).
  • The deprecation/retirement process itself → linked ticket.
  • Security backstop policy for actively maintained projects → typelevel/tsc#196

Open Questions

  • Exact reminder cadence/count before a project counts as "fully unanswered."
  • Where does the ping bot live technically (extension of typelevel/steward, a new GitHub Action, something else)?

Related


I want to declare: I used AI to challenge my thinking on this proposal and to help me write it clearly in English.

Lingua principale
Nessun dato sulla lingua
Stelle
11
Fork
4
Merge medio
2m
PR unite (30g)
1

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di typelevel/tsc

Tutte le issue di typelevel/tsc

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.