Vorgeschlagene Änderungen in einem Pull Request überprüfen

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.

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

Sie können Copilot-Chat um Hilfe beim Verständnis der Absicht des Pull-Requests oder um einen beliebigen Teil der Änderung zu klären, bitten.

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.
   

2. 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 dabei helfen, das Gesamtbild zu klären, bevor Sie in die Prüfung auf Zeilenebene eintauchen.
     

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.

   
   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.

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. Weitere Informationen finden Sie unter Dateien in einem Pull Request filtern.

5. Wenn Sie Zugriff auf GitHub Copilot Enterprise haben, können Sie optional Copilot nach den Änderungen in einer Datei in einer Pull-Anfrage fragen, indem Sie oben rechts in der Datei auf klicken, auf "Fragen Sie Copilot zu diesem Diff" klicken und dann eine Anfrage wie "Erläutern Sie diese Änderungen." eingeben. Weitere Informationen finden Sie unter Fragen an GitHub Copilot in GitHub stellen.

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

   

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

8. Gib im Kommentarfeld Deinen Kommentar ein.

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

   

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

    

11. 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)

Grundlegendes zu Änderungen in einem Pull Request

          GitHub Copilot kann Ihnen helfen, die Änderungen in einer Pullanforderung schnell zu verstehen, indem Sie Kontext und Erklärungen für bestimmte Commits bereitstellen. Wenn Sie nicht sicher sind, welchen Zweck eine bestimmte Änderung hat oder weitere Details dazu benötigen, wie sie in die breitere Codebasis passt, können Sie Fragen zu einzelnen Commits stellen Copilot .

1. Navigieren Sie zu einem Commit auf GitHub.

2. Klicke oben rechts auf einer beliebigen Seite auf GitHub neben der Suchleiste auf das Symbol .

   Das GitHub Copilot Gespräch-Panel wird angezeigt. Um die Größe des Bereichs zu ändern, klicken Sie auf den oberen oder linken Rand und ziehen Sie ihn.

3. Wenn das Panel eine vorherige Unterhaltung enthält, die du mit Copilot hattest, klicke auf das Pluszeichensymbol () oben rechts im Copilot-Panel, um eine neue Unterhaltung zu starten.

4. Geben Sie unten im Copilot Chatbereich im Feld "Frage Copilot" eine Frage ein, und drücken Sie die EINGABETASTE. Sie könnten beispielsweise eingeben:

   • Summarize the changes in this commit

   • Who committed these changes?

   • When was this commit made?

   Tipp

   Wenn Sie die SHA eines Commits kennen, können Sie, anstatt zum Commit zu navigieren, Copilot von einer beliebigen Seite im Repository auf GitHub nach dem Commit fragen, indem Sie die SHA in Ihre Nachricht einschließen. Beispiel: What changed in commit a778e0eab?

5. Optional kannst du nach der Übermittlung einer Frage im Textfeld auf klicken, um die Antwort zu beenden.

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

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 Rich-Diff-Schaltfläche 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

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.

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.