Reviewing proposed changes in a pull request

Vorgeschlagene Änderungen in einem Pull Request überprüfen

In einem Pull Request kannst du Commits, geänderte Dateien und die Differenzen (Diffs) zwischen den Dateien im Basisbranch und in den Vergleichsbranches überprüfen und besprechen. Überprüfen vorgeschlagener Änderungen Informationen zum Review von Pull Requests Du kannst die Änderungen in einem Pull Request eine Datei nach der anderen überprüfen. Beim Überprüfen der Dateien in einem Pull Request kannst du einzelne Kommentare zu bestimmten Änderungen hinterlassen. Nachdem du den Review der einzelnen Dateien abgeschlossen hast, kannst du sie als „gesehen“ markieren.

Dadurch wird die Datei ausgeblendet, so dass du die noch nicht geprüften Dateien leichter findest.

Eine Statusleiste im Pull Request-Header zeigt die Anzahl der eingesehenen Dateien an.

Nachdem du so viele Dateien wie gewünscht überprüft hast, kannst du den Pull Request genehmigen oder zusätzliche Änderungen anfordern, indem du den Review mit einem Zusammenfassungskommentar übermittelst.

Review starten

1. Klicke unter dem Namen deines Repositorys auf Pull Requests. 1. Klicke in der Liste der Pull Requests auf den Pull Request, den Du überprüfen möchtest. 1. Klicke im Pull Request auf Dateien geändert. Du kannst das Format der Diff-Ansicht auf dieser Registerkarte ändern, indem du auf klickst und die einheitliche oder geteilte Ansicht auswählst. Die getroffene Auswahl wird angewendet, wenn du die Diff-Ansicht für andere Pull Requests anzeigst.

2. Einstellungen für die Diff-Ansicht Du kannst auch Leerzeichenunterschiede ausblenden. Die getroffene Auswahl gilt nur für diesen Pull Request und wird für deinen nächsten Besuch dieser Seite gespeichert.

3. Wahlweise kannst du die Dateien filtern, um nur die Dateien anzuzeigen, die du überprüfen möchtest. Weitere Informationen findest du unter „Filtern von Dateien in einem Pull Request“.

   

Wenn du fertig bist, klicke auf Review starten. Wenn du bereits einen Review gestartet hast, kannst du auf Reviewkommentar hinzufügen klicken. Schaltfläche „Start a review“ (Review starten)

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.

Zum Abbrechen eines ausstehenden Reviews einschließlich der ausstehenden Kommentare blätterst du auf der Registerkarte „Unterhaltung“ zum Ende der Zeitleiste und klickst auf Review abbrechen.

Überprüfen von Abhängigkeitsänderungen

1. 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.

   

2. Klicke im Pull Request auf Dateien geändert.

Zeige rechts neben dem Header für eine Manifest- oder Sperrdatei den Abhängigkeitsreview an, indem du auf die Rich-Diff-Schaltfläche klickst.

Die Rich-Diff-Schaltfläche 1. 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 Quell-Diff zurückzukehren.

Datei als „gesehen“ markieren 2. Wenn du den Review einer Datei abgeschlossen hast, kannst du sie als „gesehen“ markieren, um sie auszublenden.

1. Klicke im Pull Request auf Dateien geändert.

Aktiviere rechts neben dem Header der überprüften Datei das Kontrollkästchen Gesehen.

Kontrollkästchen „Viewed“ (Gesehen) 4. Review absenden

- 1. Klicke im Pull Request auf <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-file-diff" aria-label="The file diff icon" role="img"><path d="M1 1.75C1 .784 1.784 0 2.75 0h7.586c.464 0 .909.184 1.237.513l2.914 2.914c.329.328.513.773.513 1.237v9.586A1.75 1.75 0 0 1 13.25 16H2.75A1.75 1.75 0 0 1 1 14.25Zm1.75-.25a.25.25 0 0 0-.25.25v12.5c0 .138.112.25.25.25h10.5a.25.25 0 0 0 .25-.25V4.664a.25.25 0 0 0-.073-.177l-2.914-2.914a.25.25 0 0 0-.177-.073ZM8 3.25a.75.75 0 0 1 .75.75v1.5h1.5a.75.75 0 0 1 0 1.5h-1.5v1.5a.75.75 0 0 1-1.5 0V7h-1.5a.75.75 0 0 1 0-1.5h1.5V4A.75.75 0 0 1 8 3.25Zm-3 8a.75.75 0 0 1 .75-.75h4.5a.75.75 0 0 1 0 1.5h-4.5a.75.75 0 0 1-.75-.75Z"></path></svg> **Dateien geändert**.

1. Klicke oberhalb des geänderten Codes auf Änderungen überprüfen. 1. 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:
- Optionsfelder mit Review-Optionen

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.

• 1. Klicke auf Review senden.

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.