Triaging und Kuratieren von Issues#
SciPy hat viele Hunderte offener Issues. Das Schließen ungültiger und das korrekte Kennzeichnen gültiger Issues (idealerweise mit ersten Gedanken in einem Kommentar) ermöglicht die Priorisierung von Wartungsarbeiten und das einfache Auffinden verwandter Issues bei der Arbeit an einer bestehenden Funktion oder einem Subpaket.
Während jeder Kommentare abgeben und weitere Informationen zu offenen Issues geben kann, sind zusätzliche Berechtigungen erforderlich, wenn Sie Labels zu Issues im SciPy-Repository anwenden möchten. Obwohl es keinen formellen Prozess gibt, um Triage-Rechte zu erhalten, wird erwartet, dass jemand aktiv als Mitwirkender tätig ist, bevor er dem Team beitritt.
Rollen und Berechtigungen#
SciPy verwendet zwei Ebenen von Berechtigungen: Triage- und Kernteammitglieder. Triage-Mitglieder können Issues und Pull-Requests mit Labels versehen und schließen, während Maintainer Issues und Pull-Requests mit Labels versehen und schließen und auch Pull-Requests zusammenführen können.
GitHub veröffentlicht die vollständige Liste der Berechtigungen für die Plattform.
Verbessern von Issues#
Issue-Beschreibungen können unvollständig, ungenau oder veraltet sein. Es sind keine besonderen Berechtigungen erforderlich, um an ihrer Verbesserung zu arbeiten – dies kann nützlich sein und dazu beitragen, die Arbeitsbelastung für Maintainer und andere Mitwirkende zu reduzieren. Die folgenden Aktionen sind typischerweise nützlich:
Dokumentieren von Issues, denen Elemente zur Reproduktion des Problems fehlen, wie z. B. Code-Beispiele
Vorschlagen, den Titel und die Beschreibung neu zu formulieren, um sie expliziter über das zu lösende Problem zu machen
Verknüpfen mit verwandten Issues oder Diskussionen, während kurz beschrieben wird, wie sie zusammenhängen. Zum Beispiel „Siehe auch #xyz für einen ähnlichen Versuch“ bietet Kontext und hilft der Diskussion.
Beachten Sie, dass jeder Kommentar zu einem Issue oder Pull Request eine Benachrichtigung für eine Gruppe von Personen erstellt. Seien Sie achtsam und nutzen Sie bei Bedarf die Schaltfläche „Kommentar bearbeiten“.
Fruchtbare Diskussionen#
Online-Diskussionen können schwieriger sein, als es auf den ersten Blick scheint, insbesondere da eine Person, die neu im Open-Source-Bereich ist, ein sehr anderes Verständnis des Prozesses haben kann als ein erfahrener Maintainer.
Im Allgemeinen ist es nützlich, positiv zu bleiben und guten Willen anzunehmen. Dieser Artikel untersucht, wie man Online-Diskussionen im Kontext von Open Source führt. Es ist auch wichtig, sich daran zu erinnern, dass alle Interaktionen dem SciPy Code of Conduct folgen müssen.
Issue-Labels (erfordert Triage-Rechte)#
Wenn ein Issue oder Pull Request erstellt wird, weist SciPy möglicherweise automatisch ein oder mehrere Labels zu, je nach Titel oder betroffenem Code-Abschnitt. Zum Beispiel erhalten alle Issues, die mit dem Präfix BUG: im Titel erstellt werden, automatisch ein Label defect.
In einigen Fällen kann es nützlich sein, auch andere Labels manuell einzuschließen. Jede Person mit Triage-Rechten kann Labels nach Bedarf hinzufügen oder entfernen. Überprüfen Sie die vollständige Beschreibung der aktuellen Labels für weitere Informationen.