← Übersicht← Overview

Modul 4: Feedback ohne E-Mail-Ping-PongModule 4: Feedback without email ping-pong

Modul 4 von 6 · ⏱ ca. 30 MinutenModule 4 of 6 · ⏱ ~30 minutes
Branches, Pull Requests und Reviews — der strukturierte Weg zu besserer Zusammenarbeit.Branches, pull requests, and reviews — the structured path to better collaboration.

🎯 Nach diesem Modul kannst du:🎯 After this module you can:

Das KonzeptThe concept

Ein Branch ist eine parallele Kopie deines Projekts. Du änderst dort etwas, ohne das Original zu berühren. Wenn du fertig bist, öffnest du einen Pull Request — das ist wie sagen: „Schau dir das an, bevor es übernommen wird."A branch is a parallel copy of your project. You change things there without touching the original. When done, you open a pull request — like saying: "Review this before it goes live."

🔀
BranchBranch
→
✏️
ÄnderungChange
→
💬
Pull Request
→
👀
Review
↓
✅
Merge
oderor
🔄
Feedback
Pull Request Workflow: Strukturiertes Feedback bevor Änderungen übernommen werden. Pull request workflow: structured feedback before changes go live.
1
Einen Branch erstellenCreate a branch
  1. Öffne dein Repository → klicke auf das Branch-Dropdown (zeigt „main")Open your repository → click the branch dropdown (shows "main")
  2. Tippe: entwurf-projektplanType: draft-project-plan
  3. Klicke „Create branch: entwurf-projektplan from main"Click "Create branch: draft-project-plan from main"
💡 Du bist jetzt auf dem neuen Branch. Alles was du hier änderst, bleibt getrennt vom Original (main).💡 You're now on the new branch. Everything you change here stays separate from the original (main).
✅ Dein Branch ist erstellt. Das Dropdown zeigt jetzt „entwurf-projektplan".✅ Your branch is created. The dropdown now shows "draft-project-plan".
2
Auf dem Branch ein Dokument ändernEdit a document on the branch
  1. Stelle sicher, dass oben „entwurf-projektplan" steht (nicht „main")Make sure "draft-project-plan" is shown above (not "main")
  2. Öffne README.md → Stift-Icon ✏️Open README.md → pencil icon ✏️
  3. Füge einen neuen Abschnitt hinzu: ## Nächste Schritte mit 3 PunktenAdd a new section: ## Next Steps with 3 bullet points
  4. Committe: Nächste Schritte ergänzt (Entwurf)Commit: Added next steps (draft)
✅ Änderung ist auf dem Branch gespeichert. Main ist unverändert.✅ Change is saved on the branch. Main is untouched.
3
Pull Request öffnenOpen a pull request
  1. GitHub zeigt oben einen gelben Banner: „Compare & pull request" → klicke daraufGitHub shows a yellow banner: "Compare & pull request" → click it
  2. Titel: Nächste Schritte für den ProjektplanTitle: Next steps for the project plan
  3. Beschreibung: Erkläre kurz was du geändert hast und warumDescription: Briefly explain what you changed and why
  4. Klicke „Create pull request"Click "Create pull request"
✅ Dein Pull Request ist offen! Du siehst die Diff-Ansicht deiner Änderungen.✅ Your pull request is open! You see the diff view of your changes.
4
Review-Kommentar schreibenWrite a review comment
  1. Klicke auf den Tab „Files changed"Click the "Files changed" tab
  2. Hover über eine Zeile → es erscheint ein blaues +Hover over a line → a blue + appears
  3. Klicke darauf und schreibe einen Kommentar: Sollten wir hier ein Datum ergänzen?Click it and write a comment: Should we add a date here?
  4. Klicke „Add single comment"Click "Add single comment"
💡 Der Kernvorteil: Feedback steht direkt neben der betroffenen Zeile — nicht in einer separaten E-Mail. Das spart Zeit und verhindert Missverständnisse. Stell dir das vor für Verträge, Policies, Marketingtexte…💡 The core advantage: feedback sits right next to the affected line — not in a separate email. This saves time and prevents misunderstandings. Imagine this for contracts, policies, marketing copy…
✅ Dein Kommentar ist sichtbar — direkt neben der betroffenen Zeile.✅ Your comment is visible — right next to the affected line.
5
Pull Request mergenMerge the pull request
  1. Gehe zurück zum Tab „Conversation"Go back to the "Conversation" tab
  2. Klicke „Merge pull request" → „Confirm merge"Click "Merge pull request" → "Confirm merge"
  3. Optional: Lösche den Branch („Delete branch")Optional: Delete the branch ("Delete branch")
✅ Deine Änderungen sind jetzt in main. Der Review-Prozess ist dokumentiert.✅ Your changes are now in main. The review process is documented.

🎉 Modul 4 geschafft!Module 4 complete!

Du beherrschst jetzt den Pull-Request-Workflow: Branch → Änderung → Review → Merge. Nie wieder Feedback per E-Mail-Attachment.You now master the pull request workflow: Branch → Change → Review → Merge. No more feedback via email attachments.

✅ Erfolgskriterium:✅ Success criterion:
  • Du hast einen Pull Request erstellt, reviewed und gemergedYou created, reviewed, and merged a pull request
  • Im geschlossenen PR ist mindestens 1 Review-Kommentar sichtbarThe closed PR shows at least 1 review comment
📚 „Code review suggestions make the reviewers' feedback more actionable for the submitters and represent valuable knowledge for newcomers." (Bouraffa et al., 2025, arXiv) 📚 "Code review suggestions make the reviewers' feedback more actionable for the submitters and represent valuable knowledge for newcomers." (Bouraffa et al., 2025, arXiv)

👉 Nächster Schritt: In Modul 5 wird dein Repository zu einer echten Website — in 10 Minuten, kostenlos, ohne Hosting-Setup. 👉 Next: In Module 5 your repository becomes a real website — in 10 minutes, free, no hosting setup.

📖 Glossar📖 Glossary

Branch
Eine parallele Version deines Projekts. Wie „Speichern unter…" — experimentieren ohne das Original zu ändern.A parallel version of your project. Like "Save as..." — experiment without changing the original.
Pull Request (PR)
„Schau dir meine Änderungen an, bevor sie übernommen werden." Ein strukturierter Review-Prozess."Review my changes before they go live." A structured review process.
Merge
Änderungen von einem Branch ins Original (main) übernehmen.Integrating changes from a branch into the original (main).
Review
Kommentare und Feedback direkt an den geänderten Zeilen.Comments and feedback directly on the changed lines.

💬 Feedback & Fragen