Vorgeschlagene Änderungen in einem Pull Request überprüfen

Informationen zum Überprüfen von Pull Requests

Es ist am besten, Änderungen in einer Pullanforderung jeweils einzeln zu überprüfen:

        **Überprüfen Sie** jede einzelne Datei, die in der Pullanforderung geändert wurde.

        **Hinterlassen Sie Kommentare** zu bestimmten Änderungen.

Nachdem Sie eine Datei überprüft haben, markieren Sie sie als "Angezeigt" , um sie zu reduzieren und den Fortschritt nachzuverfolgen.
Die Statusleiste im Pull-Anforderungsheader zeigt an, wie viele Dateien Sie angezeigt haben.
Wenn Sie fertig sind, können Sie die Pull-Anforderung genehmigen oder Änderungen anfordern , indem Sie Ihre Rezension mit einem Zusammenfassungskommentar übermitteln.

Den Zweck eines Pull Requests verstehen

Ein klares Verständnis der Motivation hinter einer Pull-Anforderung zu gewinnen hilft Ihnen, Ihre Bewertung gezielt und sinnvoll zu gestalten und Feedback zu geben, das mit den Absichten des Autors der Pull-Anforderung und den Zielen des Projekts übereinstimmt.

Es stehen Ihnen mehrere Optionen zur Verfügung, um den Kontext und die Gründe für vorgeschlagene Änderungen besser zu verstehen.

Verwendung der Pull-Request-Seitenleiste für den Kontext

In der Pullanforderungs-Randleiste finden Sie wertvollen Kontext, einschließlich:

Verknüpfte Probleme oder Diskussionen: Überprüfen Sie diese, um die Probleme oder Ziele zu verstehen, die von der Pull-Anforderung angesprochen werden sollen, oder um Informationen zu sammeln, z. B. zu Hintergrund, Entwurfsentscheidungen oder aktuellen Debatten.
Verknüpfte Projekte oder Meilensteine: Überprüfen Sie, wie diese Pullanforderung in größere Projekte oder anstehende Versionen passt.

Verwenden Sie diese Informationen, um Ihre Überprüfung zu framen und zu überprüfen, ob die Ziele der Pullanforderung mit der ursprünglichen Absicht übereinstimmen.

Eine Überprüfung starten

Klicke unter dem Namen deines Repositorys auf Pull requests.
Klicke in der Liste der Pull Requests auf den Pull Request, den Du überprüfen möchtest.
Klicke im Pull Request auf Files changed.

Sie können das Format der Diff-Ansicht auf dieser Registerkarte ändern, indem Sie auf die einheitliche oder geteilte Ansicht klicken und auswählen. Die getroffene Auswahl wird angewendet, wenn du die Diff-Ansicht für andere Pull Requests anzeigst.

Du kannst auch Unterschiede im Leerraum verbergen. Die getroffene Auswahl gilt nur für diesen Pull Request und wird für deinen nächsten Besuch dieser Seite gespeichert.
Wahlweise kannst du die Dateien filtern, um nur die Dateien anzuzeigen, die du überprüfen möchtest, oder die Dateistruktur verwenden, um zu einer bestimmten Datei zu navigieren. Weitere Informationen finden Sie unter Dateien in einem Pull Request filtern.
Bewege den Mauszeiger über die Codezeile, der du einen Kommentar hinzufügen möchtest, und klicke auf das blaue Kommentarsymbol.
Optional können Sie einen Kommentar zu mehreren Zeilen hinzufügen. Wenn Sie einen Zeilenbereich auswählen möchten, klicken Sie auf die Zeilennummer der ersten Zeile, die Sie kommentieren möchten, und ziehen Sie dann entweder nach unten zur letzten Zeile, oder halten Sie die UMSCHALTTASTE gedrückt, und klicken Sie auf die letzte Zeilennummer. Sie können dann auf das blaue Kommentarsymbol in der letzten Zeile klicken, zu der Sie kommentieren möchten. Alternativ können Sie auf das blaue Kommentarsymbol neben der ersten Zeile klicken, die Sie kommentieren möchten, und dann nach unten zur letzten Zeile ziehen, zu der Sie einen Kommentar abgeben möchten.
Gib im Kommentarfeld Deinen Kommentar ein.
Optional: Wenn du eine bestimmte Änderung an einer oder mehreren Zeilen vorschlagen möchtest, klicke auf , und bearbeite dann den Text im Vorschlagsblock.
Um eine Datei direkt zu kommentieren, klicke rechts neben der Datei auf , und gib deinen Kommentar ein.
Wenn du fertig bist, klicke auf Review starten. Wenn du bereits einen Review gestartet hast, kannst du auf Reviewkommentar hinzufügen klicken.

Vor dem Absenden des Reviews haben deine Zeilenkommentare den Status Ausstehend und sind nur für dich sichtbar. Ausstehende Kommentare kannst du vor dem Absenden des Reviews jederzeit bearbeiten. Um eine ausstehende Überprüfung, einschließlich aller ausstehenden Kommentare, abzubrechen, klicken Sie oberhalb des geänderten Codes auf Änderungen prüfen und dann auf Überprüfung abbrechen.

          ![Screenshot: Kommentarfeld für einen Review. Die Schaltfläche "Überprüfung aufgeben" ist in dunkel orange dargestellt.](/assets/images/help/pull_requests/abandon-review-button.png)

Überprüfen von Abhängigkeitsänderungen

Wenn der Pull Request Änderungen an Abhängigkeiten enthält, kannst du mithilfe der Abhängigkeitsüberprüfung für eine Manifest- oder Sperrdatei feststellen, was geändert wurde und ob die Änderungen Sicherheitsrisiken einführen. Weitere Informationen finden Sie unter Überprüfen von Abhängigkeitsänderungen in einem Pull Request.

Klicke im Pull Request auf Files changed.
Zeigen Sie rechts neben der Kopfzeile für eine Manifest- oder Sperrdatei die Abhängigkeitsüberprüfung an, indem Sie auf die Schaltfläche "Rich Diff" klicken.
Du solltest auch das Quell-Diff überprüfen, da es möglicherweise Änderungen an der Manifest- oder Sperrdatei gibt, die keine Abhängigkeiten ändern. Zudem besteht die Möglichkeit, dass Abhängigkeiten verfügbar sind, die GitHub nicht analysieren kann und die daher nicht in der Abhängigkeitsüberprüfung angezeigt werden.

Klicke auf die Schaltfläche , um zur Ansicht für das Quelldiff zurückzukehren.

Datei als „gesehen“ markieren

Wenn du das Überprüfen einer Datei abgeschlossen hast, kannst du die Datei als „geprüft“ markieren, und sie wird zusammenklappen. Falls die Datei nach deiner Überprüfung geändert wird, wird die Markierung aufgehoben.

Klicke im Pull Request auf Files changed.
Aktiviere rechts neben dem Header der überprüften Datei das Kontrollkästchen Gesehen.

Bewertung absenden

Wenn du den Review aller von Dir im Pull Request einzuschließenden Dateien abgeschlossen hast, sende den Review ab.

Klicke im Pull Request auf Files changed.
Klicke oberhalb des geänderten Codes auf Änderungen überprüfen.
Gib einen Kommentar ein, der Dein Feedback für die vorgeschlagenen Änderungen zusammenfasst.
Wähle die Art des Review aus, den du absenden möchtest:
- Wähle Kommentar aus, um ein allgemeines Feedback abzugeben, ohne die Änderungen explizit zu genehmigen oder weitere Änderungen anzufordern.
- Wähle Genehmigen aus, um dein Feedback abzusenden und das Zusammenführen der im Pull Request vorgeschlagenen Änderungen zu genehmigen.
- Wähle Änderungen anfordern aus, um Feedback abzusenden, auf das eingegangen werden muss, bevor der Pull Request zusammengeführt werden kann.
Klicke auf Review senden.

Tipp

Die Option Änderungen anfordern ist rein informativ und verhindert nicht das Zusammenführen, sofern kein Regelsatz und keine Schutzregel für einen klassischen Branch mit der Option „Pull Request erforderlich“ konfiguriert ist. Wenn die Option konfiguriert ist und ein Projektmitarbeiter mit admin-, owner- oder write-Zugriff auf das Repository einen Review sendet, in dem Änderungen angefordert werden, kann der Pull Request erst zusammengeführt 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.
Pull-Request-Ersteller können ihre eigenen Pull Requests nicht genehmigen.

Weiterführende Lektüre

        [AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches#require-pull-request-reviews-before-merging)

        [AUTOTITLE](/issues/tracking-your-work-with-issues/filtering-and-searching-issues-and-pull-requests)