Vorgeschlagene Änderungen in einem Pull Request überprüfen

Den Zweck eines Pull Requests verstehen

Wenn Sie den Grund für einen Pull Request verstehen, können Sie Ihr Review gezielt und aussagekräftig gestalten. Außerdem können Sie Feedback geben, das der Intention des Autors des Pull Requests und den Zielen des Projekts entspricht.

Sie haben mehrere Möglichkeiten, den Kontext und die Rationale für vorgeschlagene Änderungen besser zu verstehen.

Verwenden der Pullanforderungs-Randleiste für den Kontext

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

• Verknüpfte Probleme oder Diskussionen: Überprüfen Sie diese, um die Probleme oder Ziele zu verstehen, die die Pull-Anforderung adressieren soll. Sie können auch Informationen zu Hintergrund, Entwurfsentscheidungen oder aktuellen Debatten sammeln.
• 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.

Um die Rationale zu verstehen, verwenden Sie Copilot-Chat.

Sie können Copilot-Chat um Hilfe bitten, um den Zweck des Pull Requests zu verstehen oder einen beliebigen Teil der Änderung zu klären.

1. Klicken Sie oben rechts auf der Pullanforderungsseite auf die Schaltfläche neben der Suchleiste.

Copilot-Chat wird angezeigt, wobei die Pullanforderung als Kontext an das Eingabeaufforderungsfenster angefügt ist.

1. Gib im Promptfeld eine Frage ein, und drücke die EINGABETASTE. Sie könnten beispielsweise eingeben:

   • What problem does this pull request solve?
   • Why were these changes needed?
   • Summarize the goals of this PR based on the linked issue.
   • How does this PR relate to issue ISSUE-URL?

Copilot-Chat kann Ihnen helfen, sich ein klareres Bild vom Gesamtzusammenhang zu machen, bevor Sie mit der Prüfung auf Zeilenebene beginnen.

Eine Überprüfung starten

1. Klicke unter dem Namen deines Repositorys auf Pull requests.

   

2. Klicke in der Liste der Pull Requests auf den Pull Request, den Du überprüfen möchtest.

3. Klicke im Pull Request auf Files changed.

   Um das Format der Diff-Ansicht in dieser Registerkarte zu ändern, klicken Sie auf und wählen Sie die einheitliche oder geteilte Ansicht. Die getroffene Auswahl wird angewendet, wenn du die Diff-Ansicht für andere Pull Requests anzeigst.

   

   Sie können auch Leerzeichenunterschiede ausblenden. Die getroffene Auswahl gilt nur für diesen Pull Request und wird für deinen nächsten Besuch dieser Seite gespeichert.

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

5. Bewege den Mauszeiger über die Codezeile, der du einen Kommentar hinzufügen möchtest, und klicke auf das blaue Kommentarsymbol.

   

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

7. Gib im Kommentarfeld Deinen Kommentar ein.

8. Optional: Wenn du eine bestimmte Änderung an einer oder mehreren Zeilen vorschlagen möchtest, klicke auf , und bearbeite dann den Text im Vorschlagsblock.

   

9. Um eine Datei direkt zu kommentieren, klicke rechts neben der Datei auf , und gib deinen Kommentar ein.

   

10. 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 abzubrechen, einschließlich aller ausstehenden Kommentare, klicken Sie auf "Änderungen überprüfen", und klicken Sie dann auf " Überprüfung abbrechen".

Überprüfen von Abhängigkeitsänderungen

Wenn die Pullanforderung Änderungen an Abhängigkeiten enthält, können Sie die Abhängigkeitsüberprüfung für ein Manifest oder eine Sperrdatei verwenden, um zu sehen, was geändert wurde. Sie können auch überprüfen, ob die Änderungen Sicherheitsrisiken verursachen. Siehe Überprüfen von Abhängigkeitsänderungen in einem Pull Request.

1. Klicke im Pull Request auf Files changed.

   

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

   

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

Nachdem Sie die Überprüfung einer Datei abgeschlossen haben, können Sie die Datei als angezeigt markieren. Die Datei wird reduziert. Wenn die Datei nach dem Ansehen verändert wird, wird die Ansicht-Markierung entfernt.

1. Klicke im Pull Request auf Files changed.

   

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

1. Klicke im Pull Request auf Files changed.

   

2. Klicke oberhalb des geänderten Codes auf Änderungen überprüfen.

   

3. Gib einen Kommentar ein, der Dein Feedback für die vorgeschlagenen Änderungen zusammenfasst.

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

5. Klicke auf Review senden.