Skip to main content

Informationen zu Pull-Request-Reviews

Bei Reviews können Mitarbeiterinnen die in Pull Requests vorgeschlagenen Änderungen kommentieren, die Änderungen genehmigen oder weitere Änderungen anfordern, bevor der Pull Request gemergt wird. Repositoryadministratorinnen können festlegen, dass alle Pull Requests vor dem Mergen genehmigt werden müssen.

Informationen zu Pull-Request-Reviews

Nachdem ein Pull Request geöffnet wurde, kann jeder mit Lese-Zugriff die vorgeschlagenen Änderungen überprüfen und kommentieren. Du kannst auch spezifische Änderungen an Codezeilen vorschlagen, die der Autor direkt aus dem Pull-Request anwenden kann. Weitere Informationen findest du unter Überprüfen vorgeschlagener Änderungen in einem Pull Request.

Standardmäßig können Benutzer in öffentlichen Repositorys Reviews übermitteln, die einen Pull Review genehmigen oder Änderungen anfordern. Organisationsbesitzer und Repositoryadministratoren können einschränken, wer Pull Request-Reviews zur Genehmigung durchführen oder Änderungen anfordern kann. Weitere Informationen findest du unter Verwalten von Pull Request-Reviews in deiner Organisation und unter Verwalten von Pull Request-Reviews in deinem Repository.

Repository-Inhaber und -Mitarbeiter können von einer bestimmten Person einen Review des Pull Requests anfordern. Organisationsmitglieder können auch einen Review eines Pull Requests von einem Team mit Lesezugriff auf das Repository anfordern. Weitere Informationen findest du unter Anfordern einer Pull Request-Überprüfung. Du kannst eine Teilmenge von Teammitgliedern angeben, die automatisch anstelle des gesamten Teams zugewiesen werden sollen. Weitere Informationen findest du unter Verwalten von Code-Review-Einstellungen für dein Team.

Reviews ermöglichen eine Diskussion der vorgeschlagenen Änderungen und tragen dazu bei, dass die Änderungen den Beitragsrichtlinien des Repositorys wie auch anderen Qualitätsstandards entsprechen. Du kannst definieren, welche Personen oder Teams bestimmte Codetypen oder -bereiche in einer CODEOWNERS-Datei besitzen. Wenn durch einen Pull Request Code mit einem definierten Inhaber geändert wird, wird diese Person oder dieses Team automatisch als Reviewer angefordert. Weitere Informationen findest du unter Informationen zu Codebesitzern.

Du kannst Erinnerungen für Pull Requests planen, die überprüft werden müssen. Weitere Informationen findest du unter Verwalten geplanter Erinnerungen für Pull Requests.

Header eines Reviews, der Änderungen mit Zeilenkommentaren anfordert

Ein Review kann drei verschiedene Status haben:

  • Kommentieren: Sende allgemeines Feedback, ohne die Änderungen ausdrücklich zu genehmigen oder zusätzliche Änderungen anzufordern.
  • Genehmigen: Sende Feedback und genehmige das Mergen der im Pull Request vorgeschlagenen Änderungen.
  • Änderungen anfordern: Sende Feedback, auf das eingegangen werden muss, bevor der Pull Request gemergt werden kann.

Bild des Review-Status

Tipps:

  • Wenn erforderliche Reviews aktiviert sind und ein Mitarbeiter mit Schreib-, Administrator- oder Besitzer-Zugriff auf das Repository einen Review sendet, in dem Änderungen angefordert werden, kann der Pull Request erst gemergt werden, wenn derselbe Mitarbeiter einen weiteren Review sendet, in dem die Änderungen am Pull Request genehmigt werden.
  • Repository-Inhaber und -Administratoren können einen Pull Request sogar dann zusammenführen, wenn er keinen genehmigenden Review erhalten hat oder wenn ein Reviewer, der die Änderungen verlangt hat, die Organisation verlassen hat oder nicht verfügbar ist.
  • Wenn sowohl erforderliche Reviews wie das Verwerfen veralteter Reviews aktiviert sind und ein den Code verändernder Commit an den Branch eines genehmigten Pull Requests übermittelt wird, dann wird die Genehmigung verworfen. Der Pull Request muss erneut überprüft und genehmigt werden, bevor er zusammengeführt werden kann.
  • Wenn verschiedene offene Pull Requests jeweils einen Head-Branch aufweisen, der auf denselben Commit verweist, kannst Du sie nicht zusammenführen, wenn der Review bei einer oder bei beiden ausstehend ist oder abgelehnt wurde.
  • Wenn dein Repository Genehmigungsreviews von Personen mit Schreib- oder Administratorberechtigungen erfordert, werden alle Genehmigungen von Personen mit diesen Berechtigungen mit einem grünen Häkchen markiert, Genehmigungen von Personen ohne diese Berechtigungen erhalten ein graues Häkchen. Genehmigungen mit einem grauen Häkchen wirken sich nicht darauf aus, ob der Pull Request gemergt werden kann.
  • Ersteller von Pull Requests können ihre Pull Requests nicht selbst genehmigen.

Du kannst alle Reviews eines Pull Requests in der Zeitleiste der Unterhaltung anzeigen, und du kannst Reviews von Repository-Inhabern und -Mitarbeitern im Merge-Feld des Pull Requests sehen.

Bild von Reviews in einem Merge-Feld

Tipp: Du findest einen Pull Request, wenn du oder ein Team, dem du angehörst, mit dem Suchqualifizierer review-requested:[USERNAME] oder team-review-requested:[TEAMNAME] zum Review angefordert wirst. Weitere Informationen findest du unter Durchsuchen von Issues und Pull Requests.

Resolving conversations

You can resolve a conversation in a pull request if you opened the pull request or if you have write access to the repository where the pull request was opened.

To indicate that a conversation on the Files changed tab is complete, click Resolve conversation.

Pull request conversation with Resolve conversation button

The entire conversation will be collapsed and marked as resolved, making it easier to find conversations that still need to be addressed.

Resolved conversation

If the suggestion in a comment is out of your pull request's scope, you can open a new issue that tracks the feedback and links back to the original comment. For more information, see "Opening an issue from a comment."

Discovering and navigating conversations

You can discover and navigate to all the conversations in your pull request using the Conversations menu that's shown at the top of the Files Changed tab.

From this view, you can see which conversations are unresolved, resolved, and outdated. This makes it easy to discover and resolve conversations.

Showing the conversations menu

Erneutes Anfordern einer Überprüfung

Du kannst beispielsweise einen Review erneut anfordern, nachdem du erhebliche Änderungen an deinem Pull Request vorgenommen hast. Um einen neuen Review von einem Reviewer anzufordern, klicke auf der Randleiste der Registerkarte Unterhaltung auf das Symbol .

Erforderliche Reviews

Repositoryadministratoren können erfordern, dass alle Pull Requests eine bestimmte Anzahl von Bewertungen erhalten, bevor jemand den Pull Request in einen geschützten Branch zusammenführt. Du kannst die Genehmigung von Bewertungen von Personen mit Schreibberechtigungen im Repository oder von einem bestimmten Codebesitzer anfordern. Weitere Informationen findest du unter Informationen zu geschützten Branches.

Tipp: Bei Bedarf können Personen mit Administrator- oder Schreibzugriff auf ein Repository eine Pull Request-Überprüfung schließen. Weitere Informationen findest du unter Schließen eines Pull Request-Reviews.

Weiterführende Themen