Seminar openCode – Git und GitLab für die Zusammenarbeit

Die Zusammenarbeit an offenem Quellcode und gemeinsamer Dokumentation braucht nachvollziehbare Änderungen und klare Abstimmungswege. Das Seminar vermittelt dafür einen alltagstauglichen Git- und GitLab-Arbeitsablauf auf openCode. Dateien werden lokal bearbeitet, Änderungen bewusst zusammengestellt und über einen nachvollziehbaren Reviewprozess in den gemeinsamen Projektbestand übernommen. Die Browseroberfläche dient zur Aufgabenkoordination und Prüfung; die Kommandozeile macht den Zustand von Arbeitsverzeichnis, Index und Repository sichtbar.

Ein vorbereitetes Verwaltungsprojekt bildet den roten Faden. Mehrere Bearbeitende ändern Quelltext und Dokumentation, verknüpfen ihre Arbeit mit Issues und lösen einen gezielt eingebauten Konflikt. Besonderes Gewicht liegt auf dem Prüfen vor dem Commit, dem verständlichen Beschreiben von Änderungen und dem sicheren Zurücknehmen fehlerhafter Beiträge. Der Arbeitsablauf wird sowohl für Personen mit Entwicklungsaufgaben als auch für die fachliche Mitarbeit an Dokumenten erklärt. Die Übungen verwenden kleine, überschaubare Dateien, damit das Versionskontrollprinzip im Vordergrund bleibt.

Inhaltsübersicht

1. Arbeitsplatz und Repository vorbereiten
2. Änderungen und Commits kontrollieren
3. Branches und gemeinsame Entwicklung
4. Issues, Merge Requests und Reviews
5. Projektstand und Teamregeln sichern

1. Arbeitsplatz und Repository vorbereiten

• Lokales Git konfigurieren; Autoridentität, Arbeitsverzeichnis, Index, Commit-Historie und entfernte Repositories unterscheiden.
• HTTPS- oder SSH-Zugriff passend zur bereitgestellten Umgebung einrichten und den Zugriff ohne Offenlegung von Zugangsdaten prüfen.
• Projektoberfläche, README, Dateiansicht und Repository-Historie im Browser mit dem lokalen Zustand abgleichen.

Praxisübung: Ein Übungsrepository klonen, Konfiguration und Verbindungsweg prüfen und die Ausgangsversion in Browser und Terminal vergleichen.

2. Änderungen und Commits kontrollieren

• Status und Unterschiede prüfen, Dateien gezielt zum Index hinzufügen und zusammengehörige Änderungen in verständlichen Commits festhalten.
• Nicht versionierte Dateien und .gitignore einsetzen; automatisch erzeugte Dateien und lokale Konfigurationen bewusst behandeln.
• Unveröffentlichte Arbeitsänderungen sichern oder verwerfen und veröffentlichte Fehler mit einem nachvollziehbaren Revert korrigieren.

Praxisübung: Eine Dokumentationsänderung umsetzen, den Diff prüfen, gezielt committen und eine absichtlich fehlerhafte Änderung kontrolliert zurücknehmen.

3. Branches und gemeinsame Entwicklung

• Arbeitsbranches anlegen, wechseln und veröffentlichen; Hauptbranch, Feature-Branch und entfernte Branches auseinanderhalten.
• Fetch, Pull und Push in ihren Auswirkungen erklären; lokale und entfernte Historien vor einer Integration vergleichen.
• Mergekonflikte erkennen, betroffene Stellen fachlich auflösen und die Auflösung vor dem Abschluss erneut prüfen.

Praxisübung: Zwei konkurrierende Änderungen am selben Dokument erzeugen, den Konflikt gemeinsam auflösen und den bereinigten Projektstand prüfen.

4. Issues, Merge Requests und Reviews

• Issues mit Beschreibung, Akzeptanzkriterien und reproduzierbaren Angaben erstellen; Labels und Zuständigkeiten sinnvoll nutzen.
• Merge Requests auf ein Issue beziehen, Änderungsausschnitt prüfen und Reviewkommentare in eine überarbeitete Fassung einarbeiten.
• Freigaberegeln, Diskussionen und tatsächlich verfügbare Branch-Schutzfunktionen zu einem nachvollziehbaren Teamablauf verbinden.

Praxisübung: Ein Issue übernehmen, auf einem Branch bearbeiten, einen Merge Request erstellen und nach einer dokumentierten Gegenprüfung zusammenführen.

5. Projektstand und Teamregeln sichern

• Tags und Releases zur Kennzeichnung abgestimmter Versionen einsetzen; Änderungsbeschreibung und zugehörigen Quellstand zusammenhalten.
• Fork-basierte Mitarbeit und direkte Branch-Zusammenarbeit passend zu den Projektberechtigungen einordnen.
• Konventionen für Commits, Reviewumfang, Dokumentationspflege und Vertretung im Projekt festhalten.

Praxisübung: Einen vollständigen Änderungszyklus mit Review, Tag und Releasebeschreibung durchführen und die Zuordnung von Issue, Commit und Version nachprüfen.

Schulungsumgebung

Der Kunde stellt Git, Texteditor, Terminal und Browser sowie ein Übungsprojekt mit berechtigten Konten bereit. Schreib-, Branch- und Merge-Rechte werden vorab geprüft. Für Gruppenübungen werden mehrere getrennte Arbeitskopien und mindestens zwei Rollen benötigt.