Git für Einsteiger Kurs: mit VS Code und GitHub starten

Warum Versionskontrolle?

• Versionskontrolle statt „bericht_final_v3.docx“: wozu ein Änderungsverlauf dient
• Was Git festhält: wer wann was geändert hat – und mit welcher Begründung
• Gemeinsam an denselben Dateien arbeiten, ohne sich gegenseitig zu überschreiben
• Open Source auf GitHub: Projekte lesen, Issues melden, Verbesserungen vorschlagen
• Git neben Versionsverlauf in OneDrive und älteren Systemen wie Subversion einordnen

Git und GitHub – wer macht was?

• Git auf dem eigenen Rechner, GitHub als Plattform: was wo gespeichert wird
• GitHub, GitLab und Bitbucket als Anbieter – im Kurs arbeiten wir mit GitHub
• Verteilt arbeiten: Jede Kopie eines Repositorys enthält die vollständige Historie
• Der Weg einer Änderung: bearbeiten, vormerken, committen, pushen
• Die Handgriffe für jeden Tag: Pull zu Beginn, kleine Commits, Push zum Abschluss

Arbeitsplatz einrichten: Git, VS Code und Codespaces

• Git unter Windows, macOS und Linux installieren und die Installation prüfen
• VS Code und Git zusammenbringen: die Ansicht Quellcodeverwaltung im Überblick
• GitHub Desktop als Alternative für reine Dokumentations- und Content-Projekte
• Ohne Installation starten: einen Codespace direkt aus dem Repository öffnen
• Codespaces stoppen und löschen, das kostenlose Kontingent im Blick behalten
• Name und E-Mail einrichten, private Adresse mit der noreply-E-Mail von GitHub schützen
• VS Code als Git-Editor festlegen und Kurzbefehle (Aliase) für häufige Befehle
• Bei GitHub anmelden: Browser-Anmeldung aus VS Code und Zwei-Faktor-Authentifizierung

Das erste Repository auf GitHub

• Repository auf GitHub anlegen: README, Lizenz und .gitignore-Vorlage auswählen
• Klonen in VS Code mit „Repository klonen“ – oder git clone im Terminal
• Forken: eine eigene Kopie eines fremden Projekts, um Änderungen vorzuschlagen
• Lokalen Ordner initialisieren und mit „Auf GitHub veröffentlichen“ hochladen
• Dateien anlegen und ändern, im Nachrichtenfeld beschreiben und committen
• Die Schaltfläche „Synchronisieren“: Pull und Push in einem Schritt – und wann man sie trennt
• Abgelehnter Push: zuerst die Änderungen der anderen holen, dann erneut pushen
• Einen Fork mit „Sync fork“ auf dem Stand des Originalprojekts halten

Änderungen sehen, verstehen und zurücknehmen

• Dateistatus lesen: U, M, A und D in VS Code – und dasselbe mit git status
• Dateien umbenennen und löschen, ohne dass Git den Zusammenhang verliert
• Unterschiede in der Vergleichsansicht von VS Code lesen statt git diff im Terminal
• Verlauf einer Datei in der Zeitachse von VS Code und in der Historie auf GitHub
• Verzweigungen und Merges im Source Control Graph von VS Code verfolgen
• Änderungen verwerfen, solange sie noch nicht committet sind
• Letzten lokalen Commit zurücknehmen; reset nur als Ausblick (Vertiefung → „Git“)
• Einen bereits gepushten Commit sicher mit Revert rückgängig machen
• Der versteckte Ordner .git: was darin liegt und warum man ihn nicht von Hand ändert

Branches, Pull Requests und Konflikte

• .gitignore: node_modules, Build-Ordner und .env-Dateien aus dem Repository heraushalten
• Branch über die Statusleiste von VS Code anlegen und zwischen Branches wechseln
• Branches zusammenführen und erledigte Branches lokal und auf GitHub löschen
• Pull Request auf GitHub erstellen: Titel, Beschreibung und Ansicht „Files changed“
• Pull Requests in VS Code mit der Erweiterung „GitHub Pull Requests“ bearbeiten
• Review-Kommentare beantworten und Korrekturen in denselben Pull Request pushen
• Merge Request bei GitLab: gleiches Prinzip, anderer Name (Team-Abläufe → „Git und GitLab für Teams“)
• Merge-Konflikte erkennen und im Merge-Editor von VS Code Zeile für Zeile auflösen
• Einfache Konflikte direkt im Browser auf GitHub lösen
• Commit-Nachrichten, die andere verstehen: kurze Betreffzeile, die sagt, was sich ändert

Copilot in VS Code und auf GitHub mit Git im Griff

• Nach einem Auftrag im Agentenmodus von Copilot jede geänderte Datei in der Quellcodeverwaltung durchsehen
• Bearbeitungen des Agenten im Chat Datei für Datei behalten oder rückgängig machen
• Commit-Nachricht über das Sternsymbol im Nachrichtenfeld vorschlagen lassen und selbst nachschärfen
• Merge-Konflikt von Copilot erklären lassen, die Entscheidung im Merge-Editor selbst treffen
• Ein Issue dem Copilot cloud agent (früher Coding Agent) zuweisen und seinen Pull Request wie jeden anderen reviewen

Praxisprojekt: Beitrag zu einem Team-Handbuch auf GitHub

• Vorlage-Repository forken und im Codespace oder lokal in VS Code öffnen
• Ein Kapitel in Markdown ergänzen, in kleinen Commits festhalten und pushen
• Pull Request stellen, Review-Anmerkungen einarbeiten und einen vorbereiteten Konflikt lösen

Lernziele

• Sie erklären ohne Fachjargon, wie Git, ein Repository und GitHub zusammenhängen.
• Sie klonen und forken Repositories, committen, pushen und pullen sicher aus VS Code heraus.
• Sie arbeiten mit Branches, stellen einen Pull Request und lösen Merge-Konflikte im Merge-Editor.
• Sie vermeiden typische Fehler: Zugangsdaten im Repository, abgelehnte Pushes, verlorene Änderungen.
• Sie prüfen Änderungen eines Coding-Agenten in der Quellcodeverwaltung, bevor Sie sie committen.

Zielgruppe

• Einsteiger:innen ohne Git-Erfahrung und Quereinsteiger:innen in die Softwareentwicklung
• Studierende, die Projekte auf GitHub abgeben oder veröffentlichen
• Fachabteilungen, Redaktionen und Technische Redakteur:innen mit ersten Code- oder Doku-Projekten