Bewährte Methoden für Pull Requests (PRs)
Befolgen Sie beim Erstellen eines Pull Request einige bewährte Methoden für einen reibungsloseren Überprüfungsprozess. Weitere Informationen zum Erstellen eines Pull Request finden Sie unter Erstellen eines Pull Requests.
Schreiben kleiner PRs
Ziel ist es, kleine, fokussierte Pull Requests zu erstellen, die einen einzelnen Zweck erfüllen. Kleinere Pull Requests sind einfacher und schneller zu überprüfen und zusammenzuführen, lassen weniger Platz, um Fehler einzuführen und bieten einen klareren Verlauf der Änderungen.
Überprüfen Ihrer eigenen Pull Requests als Erstes
Überprüfen, erstellen und testen Sie Ihren eigenen Pull Request, bevor Sie ihn übermitteln. Auf diese Weise können Sie Fehler oder Tippfehler erfassen, die Sie möglicherweise verpasst haben, bevor andere mit der Überprüfung beginnen.
Bereitstellen von Kontext und Anleitungen
Schreiben Sie klare Titel und Beschreibungen für Ihre Pull Requests, damit Prüfer schnell verstehen können, was der Pull Request tut. Fügen Sie Folgendes in den Pull Request-Text ein:
- Der Zweck des Pull Requests
- Ein Überblick über die Änderungen
- Links zu zusätzlichem Kontext, z. B. zum Nachverfolgen von Issues oder früheren Unterhaltungen
Um Prüfern zu helfen, geben Sie den benötigten Feedbacktyp weiter. Benötigen Sie z. B. einen schnellen Blick oder eine tiefergehende Kritik?
Wenn Ihre Pull Request aus Änderungen an mehreren Dateien besteht, geben Sie Prüfern Anleitungen zur Reihenfolge, in der die Dateien überprüft werden sollen. Empfehlen Sie, wo Sie beginnen und wie Sie mit der Überprüfung fortfahren können.
Bewährte Methoden für die Verwaltung von Pull Requests (PRs)
Wenn Sie ein Repositoryverwalter sind, führen Sie diese Schritte aus, um die Pull Requests zu verwalten und zu standardisieren, die Mitwirkende in Ihrem Repository erstellen.
Verwenden von Pull Request-Vorlagen
Mithilfe von Pull Request-Vorlagen können Sie die Informationen anpassen und standardisieren, die Sie einbeziehen möchten, wenn jemand einen Pull Request in Ihrem Repository erstellt. Wenn du eine Pull-Request-Vorlage zu deinem Repository hinzufügst, sehen Projektmitarbeiter automatisch den Inhalt der Vorlage im Text des Pull Requests. Weitere Informationen findest du unter Eine Pull-Request-Vorlage für dein Repository erstellen.
Mithilfe von Pull Request-Vorlagen können Sie den Überprüfungsprozess für Ihr Repository standardisieren. Sie können z. B. eine Liste von Aufgaben einschließen, die Autoren vor dem Zusammenführen ihrer Pull Requests ausführen möchten, indem Sie der Vorlage eine Aufgabenliste hinzufügen. Weitere Informationen findest du unter Informationen zu Aufgabenlisten.
Sie können anfordern, dass Mitwirkende einen Problemverweis in ihren Pull Request-Text einschließen, sodass das Zusammenführen des Pull Request das Issue automatisch schließt. Weitere Informationen findest du unter Einen Pull Request zu einem Issue verknüpfen.
Definieren von Codebesitzern
Möglicherweise möchten Sie sicherstellen, dass bestimmte Personen immer Änderungen an bestimmtem Code oder Dateien in Ihrem Repository überprüfen. Sie können z. B. darauf bestehen, dass ein technischer Redakteur in Ihrem Team immer Änderungen im docs-Verzeichnis überprüft.
Sie können Personen oder Teams definieren, die für den Code oder die Dateien in einem Repository als Codebesitzer verantwortlich sind. Codebesitzer werden automatisch zur Überprüfung aufgefordert, wenn jemand einen Pull Request öffnet, der die Dateien ändert, die sie besitzen. Sie können Codebesitzer für bestimmte Dateitypen oder Verzeichnisse sowie für verschiedene Branches in einem Repository definieren. Weitere Informationen findest du unter Informationen zu Codeinhabern.
Verwenden von geschützten Branches
Sie können geschützte Branches verwenden, um zu verhindern, dass Pull Requests in wichtige Branches zusammengeführt werden, z B. main, bis bestimmte Bedingungen erfüllt sind. Sie können z. B. CI-Tests oder eine Überprüfung für die Genehmigung erfordern. Weitere Informationen findest du unter Informationen zu geschützten Branches.
Verwenden von automatisierten Tools zum Überprüfen der Codeformatierung
Verwenden Sie automatisierte Tools wie Linters in den Pull Requests Ihres Repositorys, um konsistente Formatierungen beizubehalten und Code verständlicher zu gestalten. Wenn Sie automatisierte Tools verwenden, um kleinere Probleme wie Tippfehler oder Formatierung zu erfassen, bleibt mehr Zeit für Prüfer, sich auf die Substanz eines Pull Requests zu konzentrieren.
Sie können z. B. GitHub Actions verwenden, um Code-Linters einzurichten, die im Rahmen Ihres CI (Continuous Integration)-Workflows auf Pull Requests ausgeführt werden können. Weitere Informationen findest du unter Info zu Continuous Integration mit GitHub Actions.