Erkunden des GitHub-Flows
GitHub ist das beste Tool, um die Zusammenarbeit in Ihren Projekten zu ermöglichen. Der GitHub-Flow ist ein branchbasierter Workflow, der für GitHub vorgeschlagen wird.
Hinweis
Um den GitHub-Flow zu implementieren, benötigen Sie ein GitHub-Konto und ein Repository. Informationen hierzu finden Sie unter Registrieren für GitHub und unter Erstellen eines Repositorys.
Tipp
Sie können alle Schritte des GitHub-Flows über die GitHub-Webschnittstelle, die Befehlszeile, die GitHub CLI oder den GitHub Desktop ausführen.
Im ersten Schritt erstellen Sie einen Branch in Ihrem Repository, um bei Ihrer Arbeit den Standardbranch nicht zu beeinträchtigen, und geben Mitarbeitern die Möglichkeit zum Überprüfen Ihrer Arbeit.
Weitere Informationen finden Sie unter Erstellen und Löschen von Branches innerhalb Ihres Repositorys.
Nehmen Sie die gewünschten Änderungen am Repository vor. Wenn Sie einen Fehler machen, können Sie die Änderungen zurücksetzen oder zusätzliche Änderungen pushen, um den Fehler zu beheben.
Committen und pushen Sie Ihre Änderungen an Ihren Branch, um Ihre Arbeit im Remotespeicher zu sichern, und versehen Sie jeden Commit mit einer beschreibenden Nachricht. Jeder Commit sollte eine isolierte, vollständige Änderung enthalten, die einfach zurückgesetzt werden kann, wenn Sie einen anderen Ansatz wählen.
Jeder, der mit Ihnen an Ihrem Projekt zusammenarbeitet, kann Ihre Arbeit sehen, Fragen beantworten und Vorschläge oder Beiträge einreichen. Fahren Sie mit dem Erstellen, Committen und Pushen von Änderungen an Ihren Branch fort, bis Sie dazu bereit sind, Feedback einzufordern.
Tipp
Sie können für jede Änderung einen separaten Branch erstellen, damit Reviewer leichter Feedback geben oder Sie die Unterschiede besser nachvollziehen können.
Sobald Sie bereit sind, können Sie einen Pull Request erstellen, um Mitarbeiter um Feedback zu Ihren Änderungen zu bitten. Informationen hierzu finden Sie unter Erstellen eines Pull Requests.
Der Pull Request-Review ist eines der wichtigsten Features für die Zusammenarbeit. Sie können vor dem Mergen von Änderungen Genehmigungen von Ihren Kollegen und Ihrem Team anfordern. Außerdem können Sie den Pull Request als Entwurf markieren, wenn Sie frühes Feedback oder eine Beratung wünschen, bevor Sie Ihre Änderungen abschließen.
Beschreiben Sie den Pull Request so genau wie möglich mit den vorgeschlagenen Änderungen und dem Problem, das behoben werden soll. Sie können Bilder, Links, verwandte Issues oder Informationen hinzufügen, um Ihre Änderung zu dokumentieren und den Reviewern den Pull Request verständlich zu machen, ohne dass sie jede Datei öffnen müssen. Weitere Informationen finden Sie unter Grundlegende Schreib- und Formatierungssyntax und unter Verknüpfen eines Pull Requests mit einem Issue.
Eine weitere Möglichkeit, die PR-Qualität und -Dokumentation zu verbessern und die Reviewer explizit auf einen Aspekt hinzuweisen, besteht darin, den Kommentarsitzungsbereich zu verwenden. Außerdem können Sie eine Erwähnung über @mention einbeziehen oder einen Review von bestimmten Personen oder Teams anfordern.
Es gibt noch weitere Pull Request-Konfigurationen, z. B. das automatische Anfordern eines Reviews von bestimmten Teams oder Benutzern bei Erstellen eines Pull Requests oder die für Pull Requests auszuführenden Überprüfungen. Weitere Informationen finden Sie unter Informationen zu Statusüberprüfungen und unter Informationen zu geschützten Branches.
Nach dem Validieren der Kommentare und Überprüfungen der Reviewer sollten die Änderungen zum Mergen bereit sein, und der Pull Request kann genehmigt werden. Informationen hierzu finden Sie unter Mergen eines Pull Requests.
Wenn Konflikte auftreten, werden Sie von GitHub informiert, damit Sie sie auflösen können. Beheben von Mergekonflikten
Nach einem Mergen eines erfolgreichen Pull Requests gibt es keine Notwendigkeit, den Remotebranch beizubehalten. Sie können Ihren Branch löschen, um zu verhindern, dass andere Personen versehentlich alte Branches verwenden. Weitere Informationen finden Sie unter Löschen und Wiederherstellen von Branches in einem Pull Request.
Hinweis
GitHub behält den Verlauf von Commits und Merges bei, falls Sie Ihren Pull Request wiederherstellen oder zurücksetzen müssen.