|
| 1 | +--- |
| 2 | +title: Git-Workflow für Fork und Branch |
| 3 | +author: Wale Soyinka |
| 4 | +contributors: Ganna Zhyrnova |
| 5 | +tags: |
| 6 | + - GitHub |
| 7 | + - git |
| 8 | + - gh |
| 9 | + - git fetch |
| 10 | + - git add |
| 11 | + - git pull |
| 12 | + - git checkout |
| 13 | + - gh repo |
| 14 | +--- |
| 15 | + |
| 16 | +## Fork und Branch Workflow |
| 17 | + |
| 18 | +Bei diesem Workflow-Typ verzweigen Mitwirkende das Haupt-Repository in ihr eigenes GitHub-Konto, erstellen Feature-Branches für ihre Arbeit und übermitteln dann Beiträge über Pull Requests aus diesen Branches. |
| 19 | + |
| 20 | +Dieses Gemstone führt Sie durch die Einrichtung eines lokalen Repositorys, um zu einem GitHub-Projekt beizutragen. Es beginnt mit der ersten Projektaufspaltung, dem Einrichten eines lokalen und eines Remote-Repositorys, dem Übernehmen von Änderungen und dem Erstellen einer Pull Request (PR) zum Einreichen Ihrer Beiträge. |
| 21 | + |
| 22 | +## Voraussetzungen |
| 23 | + |
| 24 | +- Ein Github-Konto. |
| 25 | +- `git` und `GitHub CLI (gh)` sind auf Ihrem System installiert. |
| 26 | +- Ein persönlicher Fork des Projekts auf GitHub. |
| 27 | + |
| 28 | +## Prozedur |
| 29 | + |
| 30 | +1. Falls es noch nicht vorhanden ist, erstellen Sie mit dem Dienstprogramm `gh` einen Fork des Projekts. Geben Sie bitte Folgendes ein: |
| 31 | + |
| 32 | + ```bash |
| 33 | + gh repo fork rocky-linux/documentation --clone=true --remote=true |
| 34 | + ``` |
| 35 | + |
| 36 | + Die in diesem _gh repo fork_-Befehl verwendeten Optionen sind: |
| 37 | + |
| 38 | + - `--clone=true`: Klont das Fork-Repository auf Ihren lokalen Computer. |
| 39 | + - `--remote=true`: Fügt das ursprüngliche Repository als Remote hinzu, sodass Sie zukünftige Updates synchronisieren können. |
| 40 | + |
| 41 | +2. Navigieren Sie zum lokalen Repository-Verzeichnis. Geben Sie bitte Folgendes ein: |
| 42 | + |
| 43 | + ```bash |
| 44 | + cd documentation |
| 45 | + ``` |
| 46 | + |
| 47 | +3. Überprüfen Sie, ob alle relevanten Remote-Repositorys in Ihrem lokalen Repository ordnungsgemäß konfiguriert wurden. Geben Sie Folgendes ein: |
| 48 | + |
| 49 | + ```bash |
| 50 | + git remote -vv |
| 51 | + ``` |
| 52 | + |
| 53 | +4. Holen Sie sich die neuesten Änderungen vom Upstream-Remote: |
| 54 | + |
| 55 | + ```bash |
| 56 | + git fetch upstream |
| 57 | + ``` |
| 58 | + |
| 59 | +5. Erstellen und checken Sie einen neuen Feature-Branch mit dem Namen `your-feature-branch` aus: |
| 60 | + |
| 61 | + ```bash |
| 62 | + git checkout -b your-feature-branch |
| 63 | + ``` |
| 64 | + |
| 65 | +6. Nehmen Sie Änderungen vor, fügen Sie neue Dateien hinzu und übertragen Sie Ihre Änderungen in Ihr lokales Repository: |
| 66 | + |
| 67 | + ```bash |
| 68 | + git add . |
| 69 | + git commit -m "Your commit message" |
| 70 | + ``` |
| 71 | + |
| 72 | +7. Synchronisieren Sie das Repo mit dem Hauptzweig des Remote-Repos mit dem Namen `upstream`: |
| 73 | + |
| 74 | + ```bash |
| 75 | + git pull upstream main |
| 76 | + ``` |
| 77 | + |
| 78 | +8. Übertragen Sie Push-Änderungen an Ihren Fork\*\*: |
| 79 | + |
| 80 | + ```bash |
| 81 | + git push origin your-feature-branch |
| 82 | + ``` |
| 83 | + |
| 84 | +9. Erstellen Sie abschließend einen Pull Request (PR) mit der CLI-Anwendung `gh`: |
| 85 | + |
| 86 | + ```bash |
| 87 | + gh pr create --base main --head your-feature-branch --title "Your PR Title" --body "Description of your changes" |
| 88 | + ``` |
| 89 | + |
| 90 | + Die in diesem `gh pr create`-Befehl verwendeten Optionen sind: |
| 91 | + |
| 92 | + `--base` main: Gibt den Basiszweig im Upstream-Repository an, in dem die Änderungen mit `merge` zusammengeführt werden. |
| 93 | + `--head` your-feature-branch: Gibt den Head-Branch Ihres Forks an, der die Änderungen enthält. |
| 94 | + `--title` "Ihr PR-Titel": Legt den Titel für das Pull Request fest. |
| 95 | + `--body` "Beschreibung Ihrer Änderungen": Bietet eine detaillierte Beschreibung der Änderungen im Pull Request. |
| 96 | + |
| 97 | +## Zusammenfassung |
| 98 | + |
| 99 | +Der Fork-and-Branch-Workflow ist eine weitere gängige Zusammenarbeitstechnik. |
| 100 | +Die wichtigsten Schritte sind: |
| 101 | + |
| 102 | +1. Der Fork-and-Branch-Workflow ist eine weitere gängige Zusammenarbeitstechnik. |
| 103 | +2. Den Fork klonen: Klonen Sie Ihren Fork für Entwicklungsarbeiten auf Ihren lokalen Computer. |
| 104 | +3. Upstream-Remote festlegen: Um über die Änderungen auf dem Laufenden zu bleiben, fügen Sie das ursprüngliche Projekt-Repository als `upstream`-Remote hinzu. |
| 105 | +4. Feature Branch erstellen: Erstellen Sie für jede neue Funktion oder Korrektur einen neuen Branch aus dem aktualisierten Main Branch. Der Name der Branch sollte die Funktion oder den Fix beschreiben. |
| 106 | +5. Commit der Änderungen: Nehmen Sie Ihre Änderungen vor und `commit`en Sie sie mit klaren und präzisen `Commit`-Nachrichten fest. |
| 107 | +6. Mit Upstream synchronisieren: Synchronisieren Sie Ihren Fork und Feature-Branch regelmäßig mit dem Upstream-Main-Branch, um neue Änderungen zu integrieren und `merge`-Konflikte zu reduzieren. |
| 108 | +7. Erstellen Sie einen Pull Request (PR): Pushen Sie Ihren Feature-Branch zu Ihrem Fork auf GitHub und öffnen Sie einen PR für das Hauptprojekt. Ihre PR sollte die Änderungen klar beschreiben und auf alle relevanten Probleme verweisen. |
| 109 | +8. Auf Feedback reagieren: Arbeiten Sie gemeinsam an der Überprüfung des Feedbacks, bis der PR zusammengeführt oder geschlossen wird. |
| 110 | + |
| 111 | +Vorteile: |
| 112 | + |
| 113 | +- Isoliert die Entwicklungsarbeit auf bestimmte Zweige und hält den Hauptzweig sauber. |
| 114 | +- Es erleichtert das Review und die Integration von Änderungen. |
| 115 | +- Reduziert das Risiko von Konflikten mit der sich entwickelnden Codebasis des Hauptprojekts. |
0 commit comments