Informationen zum Review von Pull Requests
Du kannst die Änderungen in einem Pull Request eine Datei nach der anderen überprüfen. While reviewing the files in a pull request, you can leave individual comments on specific changes. After you finish reviewing each file, you can mark the file as viewed. Dadurch wird die Datei ausgeblendet, so dass Du die noch nicht geprüften Dateien leichter findest. A progress bar in the pull request header shows the number of files you've viewed. After reviewing as many files as you want, you can approve the pull request or request additional changes by submitting your review with a summary comment.
Tip: Mit den Suchbegriffen review-requested:[USERNAME] oder team-review-requested:[TEAMNAME] kannst Du einen Pull Request finden, bei dem Du oder ein Team, in dem Du Mitglied bist, zu einem Review aufgefordert ist. Weitere Informationen findest Du unter „Suchen von Issues und Pull Requests."
Review starten
-
Klicken Sie unter dem Namen des Repositorys auf Pull requests.
-
Klicke in der Liste der Pull Requests auf den Pull Request, den Du überprüfen möchtest.
-
On the pull request, click Files changed.
-
Führe den Mauszeiger über die Codezeile, wo Du einen Kommentar hinzufügen willst und klicke auf das blaue Kommentarsymbol. Um einen Kommentar zu mehreren Zeilen hinzuzufügen, klicke und ziehe den Mauszeiger, um den Zeilenbereich auszuwählen, und klicke dann auf das blaue Kommentarsymbol.
-
Gib im Kommentarfeld Deinen Kommentar ein.
-
Um optional eine bestimmte Änderung an der Zeile oder den Zeilen vorzuschlagen, klicke auf und bearbeite den Text innerhalb des Vorschlagsblocks.
-
Wenn Du fertig bist, klicke auf Start a review (Review starten). Nachdem Du einen Review begonnen hast, kannst Du auf Add review comment (Review-Kommentar hinzufügen) klicken.
Vor dem Absenden Deines 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 noch nicht abgesendeten Reviews einschließlich der ausstehenden Kommentare blättere auf der Registerkarte „Conversation“ (Unterhaltung) an das Ende der Zeitleiste und klicke auf Cancel review (Review abbrechen).
Datei als „gesehen“ markieren
Wenn Sie den Review einer Datei abgeschlossen haben, können Sie sie als „gesehen“ markieren, um sie auszublenden. Falls die Datei nach Ihrer Überprüfung geändert wird, wird die Markierung aufgehoben und die Datei wird wieder eingeblendet.
-
On the pull request, click Files changed.
-
Aktiviere rechts neben dem Header der überprüften Datei das Kontrollkästchen Viewed (Gesehen).
Review absenden
Wenn Sie den Review der Dateien des Pull Requesta abgeschlossen haben, senden Sie den Review ab.
-
On the pull request, click Files changed.
-
Klicke oberhalb des veränderten Code auf Review changes (Ä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 Comment (Kommentar) aus, um ein allgemeines Feedback abzugeben, ohne die Änderungen explizit zu genehmigen oder weitere Änderungen anzufordern.
- Wähle Approve (Genehmigen) aus, um Dein Feedback abzusenden und den Merge der im Pull Request vorgeschlagenen Änderungen zu genehmigen.
- Wähle Request changes (Änderungen anfordern) aus, um Feedback einzureichen, das vor dem Merge des Pull Requests bearbeitet werden muss.
-
Klicke auf Submit review (Review einreichen).
Tips:
- Wenn erforderliche Reviews aktiviert sind und ein Mitarbeiter mit Zugriffsberechtigung write (Schreiben), admin (Administrator) oder owner (Inhaber) auf das Repository einen Review mit Anforderungen für Änderungen absendet, kann der Pull Request erst zusammengeführt werden, wenn derselbe Mitarbeiter einen anderen Review absendet, der die Änderungen in dem Pull Request genehmigt.
- 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.
- If your repository requires approving reviews from people with write or admin permissions, then any approvals from people with these permissions are denoted with a green check mark, and approvals from people without these permissions have a gray check mark. Approvals with a gray check mark do not affect whether the pull request can be merged.
- Pull request authors cannot approve their own pull requests.