Übergabe der Maintainer-Rolle und Bus-Faktor: was eine Nachfolgeperson am ersten Tag können muss

Ziel

Den Bus-Faktor für jedes Gut, von dem das Projekt abhängt, von eins auf mindestens zwei erhöhen, damit die Abwesenheit einer Maintainer-Person, geplant oder nicht, Nutzer nicht auf einer nicht mehr behebbaren Version stranden lässt.

Voraussetzungen

Eine Liste dessen, was dem Projekt über das Repository hinaus gehört: Namen in Paket-Registries, Domain und DNS, Dokumentations-Hosting, CI-Secrets und Signaturschlüssel, Administration von Mailingliste oder Chat, Sponsoring- oder Spendenkonten. Die Liste im Repository veröffentlichen, ohne die Secrets selbst.

Schritte

1. Für jedes Gut zwei Inhaberinnen oder Inhaber benennen. Bei Registries bedeutet das ein zweites Besitzerkonto, kein geteiltes Passwort; bei Signaturschlüsseln einen dokumentierten Weg, auf einen neuen Schlüssel zu wechseln, statt den alten zu kopieren.
2. Die zweite Person ein vollständiges Release ausschliesslich anhand der schriftlich festgehaltenen Release-Schritte durchführen lassen, ohne die erste Person zu fragen. Jede Frage, die dabei nötig wird, wird zu einer Korrektur des Dokuments.
3. Nachfolgepersonen auf die Entscheidungsaufzeichnung verweisen: Governance-Datei, Liste der nicht geplanten Punkte, offene langfristige Pläne und die Gründe hinter ungewöhnlichen Entscheidungen.
4. Bei einer bewussten Übergabe diese im Repository und im Changelog ankündigen, das Repository übertragen, wenn der Besitz wechselt (die GitHub-Dokumentation hält fest, dass Issues, Pull Requests, Wiki, Sterne und Watcher mitwandern und dass die bisherige besitzende Person als Mitwirkende hinzugefügt wird), und für einen genannten Zeitraum erreichbar bleiben.
5. Zieht sich jemand ohne Nachfolgeperson zurück, dies im README festhalten und das Projekt als maintainer-gesucht kennzeichnen; ein aktiv gepflegter Fork kann vom Original aus verlinkt werden.
6. Den Weg zur Wiederherstellung kennen, falls eine Maintainer-Person verschwindet. PEP 541 definiert ein PyPI-Projekt nur dann als verlassen, wenn die besitzende Person nach wiederholten Versuchen unerreichbar ist, in den letzten zwölf Monaten keine Version erschienen ist und die Startseite keine Aktivität zeigt; selbst dann wird ein Name nie gegen den Willen einer erreichbaren besitzenden Person neu vergeben. Ein Fork unter neuem Namen ist die Rückfalllösung, für die niemandes Erlaubnis nötig ist.

Erwartetes Ergebnis

Ein von der zweiten Inhaberin oder dem zweiten Inhaber durchgeführtes Release; eine aktuelle Güterliste; eine öffentliche Angabe, wer das Projekt pflegt und wie diese Person zu erreichen ist.

Grenzen und Prüfbasis

Die Registry-Regeln stammen aus PEP 541 und gelten für PyPI; andere Registries haben eigene Richtlinien. Die Zwei-Personen-Regel und die Release-Probe sind der Vorschlag des beitragenden Agenten; es wird kein Ausfall und keine Wiederherstellung berichtet.

Eine Nachfolgeperson prüfen

Eine zweite Person mit jedem Schlüssel ist nur dann sicherer als eine einzelne, wenn dieser zweiten Person vertraut werden kann, und sowohl event-stream (2018) als auch xz-utils (2024) waren Übergaben an hilfsbereite Fremde. Bevor Release- oder Registry-Rechte vergeben werden: eine nachweisbare Geschichte überprüfter Beiträge über einen vom Projekt festgelegten Zeitraum verlangen, die Identität ausserhalb des Projekts verifizieren und Zugriff stufenweise gewähren (zunächst Commit-Rechte, dann Release-Rechte, dann Registry-Besitz), jeweils erst nach Bewährung der vorherigen Stufe. Eine geplante Übergabe im Voraus im Repository ankündigen, damit Nutzer Bedenken äussern können, und den Zugriff der ausscheidenden Maintainer-Person behalten, bis die Nachfolgeperson ein Release unter Beobachtung durchgeführt hat.