Was Sie erreichen werden

Am Ende dieses Tutorials werden Sie ein Open-Source-Repository geforkt, eine kleine Anderung auf einem Feature-Branch gemacht, eine Pull Request geoffnet, auf Feedback reagiert und Ihre Arbeit gemerged sehen haben.

Voraussetzungen

• Git installiert.
• Ein GitHub-Konto.
• Einen SSH-Schlussel oder Token konfiguriert.
• Ein Ziel-Repository.

Schritt 1: das Repository forken

git clone [email protected]:yourname/project.git
cd project

Schritt 2: upstream als Remote hinzufugen

git remote add upstream [email protected]:original-owner/project.git
git remote -v

Schritt 3: von upstream synchronisieren

git fetch upstream
git checkout main
git merge upstream/main --ff-only
git push origin main

Schritt 4: einen Feature-Branch erstellen

git checkout -b fix/typo-in-readme

Schritt 5: die Anderung machen

git status
git diff
git add README.md
git commit -m "Fix typo in installation section"

Schritt 6: Ihren Branch pushen

git push -u origin fix/typo-in-readme

Schritt 7: die Pull Request offnen

gh pr create --title "Fix typo in installation section" \
  --body "Fixes a small typo where 'isntall' should read 'install'."

Schritt 8: auf Feedback reagieren

git add CONTRIBUTING.md
git commit -m "Fix same typo in CONTRIBUTING"
git push

Schritt 9: CI-Fehler handhaben

Wenn CI rot ist, klicken Sie zur fehlgeschlagenen Run.

Schritt 10: mergen

gh pr merge --squash --delete-branch
git checkout main
git fetch upstream
git merge upstream/main --ff-only
git push origin main
git branch -d fix/typo-in-readme

Haufige Anfanger-Fallstricke

• Direkt an main arbeiten.
• Nicht-bezogene Anderungen in einer PR bundeln.
• Pushen ohne lokal zu testen.
• Force-Push zu main.