(Entwurf)

Konzept.docx, Konzept_v2.docx, Konzept_v2_final.docx, Konzept_v3_wirklich_final.docx Wenn dir solche Dateinamen bekannt vorkommen, kennst du bereits das Problem, für das Versionsverwaltungssysteme erfunden wurden: Du möchtest etwas überarbeiten, ohne den Überblick über frühere Fassungen zu verlieren.

Git ist (mit weitem Abstand) der etablierteste Vertreter solcher Systeme und kommt aus der Softwareentwicklung. Dort ist genau diese Rückverfolgbarkeit von jeder noch so kleinen oder komplexen Änderungen essenziell, um auch Jahre später noch die eigenen und fremde Entscheidungen nachvollziehen zu können oder einen funktionierenden Stand wiederherstellen zu können, falls es nach einem Update mal Probleme gibt.

Du musst aber nicht programmieren können, um Git zu benutzen. Mit Git lassen sich beliebige Dateien verwalten. Reine Textdateien haben dabei den Vorteil, dass sie leicht zu vergleichen sind. Aber auch Bilder, PDFs und andere Dateien lassen sich damit verwalten.

Drei Begriffe

Du arbeitest weiterhin mit deinen Dateien und speicherst sie wie gewohnt. Wenn du einen sinnvollen Zwischenstand erreicht hast, hältst du ihn zusätzlich in Git fest. Dazu schreibst du eine kurze Nachricht, zum Beispiel „Mitgliedsbeitrag für das neue Jahr aktualisiert“.

So entsteht eine Reihe nachvollziehbarer Zwischenstände. Nicht jedes Speichern oder jeder Tastendruck werden aufgezeichnet, sondern nur das, was du bewusst festhältst. Du kannst mehrere zusammengehörige Änderungen gemeinsam aufnehmen oder nur einen Teil deiner Arbeit.

Schaubild des Repositories vereinswebsite: Drei Commits halten von links nach rechts den ersten Text, einen geänderten Beitrag und einen ergänzten Termin fest. Jeder Punkt steht für einen Stand des gesamten Projekts.
Jeder Commit hält einen Projektstand fest.

Repository: Projektordner mit Geschichte

Ein Repository, oft kurz „Repo“ genannt, ist ein Projektordner mit einer Git-Versionsverwaltung. Bei unserer Vereinswebsite enthält er zum Beispiel die Dateien startseite.md, mitgliedschaft.md und termine.md.

Die Endung .md steht für Markdown. Das sind gewöhnliche Textdateien, in denen sich Überschriften oder Listen mit einfachen Zeichen markieren lassen. Für diesen Einstieg reicht normaler Text völlig aus. Git speichert seine eigenen Informationen in einem versteckten Unterordner namens .git. Den musst du nicht von Hand bearbeiten.

Commit: ein bewusst gespeicherter Zwischenstand

Ein Commit hält den ausgewählten Stand deiner Dateien fest. Dazu gehören eine Nachricht, ein Zeitstempel sowie der eingestellte Name und die E-Mail-Adresse der Person, die den Commit erstellt hat.

„Preise aktualisiert“ hilft dir später mehr als „Änderungen“ oder „Neuer Stand“. Ein Commit muss keine fertige Website sein. Er sollte nur eine Änderung festhalten, die für sich verständlich ist.

Diff: der Unterschied zwischen zwei Fassungen

Ein Diff zeigt, welche Zeilen entfernt und welche hinzugefügt wurden. Bei Textdateien kannst du so die eigentliche Änderung lesen, statt zwei komplette Dokumente miteinander zu vergleichen.

- Der Jahresbeitrag beträgt 30 Euro.
+ Der Jahresbeitrag beträgt 35 Euro.
Ein vereinfachter Diff: Minus kennzeichnet die alte, Plus die neue Zeile.

Die Zeichen gehören zur Darstellung des Vergleichs, nicht zu deinem eigentlichen Text. Viele Programme zeigen die beiden Fassungen auch nebeneinander an.

Einmal praktisch: einen Text ändern und festhalten

Für den ersten Versuch verwenden wir GitHub Desktop. Das ist eine kostenlose grafische Oberfläche für Git auf Windows und macOS. Trotz des Namens kannst du damit rein lokal arbeiten, ohne GitHub-Account. Für Linux gibt es andere Oberflächen, etwa GitKraken; die folgenden Schritte beziehen sich auf GitHub Desktop.

Installiere GitHub Desktop und überspringe die Anmeldung mit „Skip this step“. Richte einen Namen und eine E-Mail-Adresse für deine Commits ein. Das ist kein Benutzerkonto, sondern die Kennzeichnung deiner Änderungen. Diese Angaben bleiben in der Commit-Geschichte und können sichtbar werden, wenn du das Repository später teilst.

Verwende nur erfundene Texte in einem neuen Übungsordner, nicht deine einzige Kopie wichtiger Unterlagen. GitHub Desktop verwaltet die Änderungen; den Text bearbeitest du mit einem einfachen Texteditor. Die Bezeichnungen in der Oberfläche können je nach Version etwas variieren.

1. Ein Repository und den ersten Text anlegen

Wähle in GitHub Desktop „File → New repository“. Gib als Namen vereinswebsite ein und wähle einen Speicherort auf deinem Rechner. Die Optionen für README, .gitignore und Lizenz brauchst du für diesen Versuch nicht. Klicke auf „Create repository“.

Öffne den neuen Projektordner über „Repository → Show in Explorer“ beziehungsweise „Show in Finder“. Lege mit deinem Texteditor die Datei mitgliedschaft.md an und schreibe „Der Jahresbeitrag beträgt 30 Euro.“ hinein. Speichere sie als reine Textdatei; achte darauf, dass sie nicht versehentlich mitgliedschaft.md.txt heißt.

Zurück in GitHub Desktop erscheint die Datei unter „Changes“. Lass das Häkchen neben ihr gesetzt, trage im Feld „Summary“ die Nachricht „Ersten Text zur Mitgliedschaft angelegt“ ein und klicke auf den Commit-Button. Damit ist der erste Stand deines Textes in Git festgehalten. Falls das Programm schon einen Initial-Commit angelegt hat, steht dieser zusätzlich in der Geschichte.

Illustration von GitHub Desktop: Die neue Datei mitgliedschaft.md ist unter Changes ausgewählt, darunter stehen Commit-Nachricht und Commit to main.
KI-generierte Illustration: einen ersten Text-Commit erstellen. Die tatsächliche Oberfläche kann abweichen.

2. Den Text ändern und vergleichen

Ändere den Beitrag im Texteditor von 30 auf 35 Euro und speichere die Datei. GitHub Desktop zeigt sie erneut unter „Changes“ an. Wähle sie aus, um den Diff zu sehen: Die alte Zeile wird als entfernt, die neue als hinzugefügt dargestellt.

Bis hierhin ist die Änderung in deiner Datei gespeichert, aber noch nicht in einem neuen Commit.

Illustration eines Diffs in GitHub Desktop: Die Zeile mit 30 Euro ist mit Minus als entfernt markiert, die Zeile mit 35 Euro mit Plus als hinzugefügt.
KI-generierte Illustration: Der Diff zeigt den geänderten Jahresbeitrag.

3. Die Änderung bewusst aufnehmen

Prüfe den Unterschied und lass das Häkchen neben der Datei gesetzt. Wenn mehrere Dateien geändert wurden, kannst du über die Häkchen auswählen, welche in diesen Commit gehören.

Schreibe „Jahresbeitrag auf 35 Euro angepasst“ ins Feld „Summary“ und erstelle den Commit. Du hast deinen Text jetzt zweimal festgehalten: einmal mit 30 und einmal mit 35 Euro. Alles liegt weiterhin nur auf deinem Rechner. „Publish repository“ brauchst du für diese Übung nicht.

4. Eine frühere Fassung ansehen

Wechsle in GitHub Desktop von „Changes“ zu „History“. Wähle den Commit „Ersten Text zur Mitgliedschaft angelegt“ und darin die Datei mitgliedschaft.md. Der damalige Diff zeigt den ursprünglichen Text mit 30 Euro. Beim späteren Commit siehst du dagegen den Wechsel auf 35 Euro.

Illustration der History in GitHub Desktop: Unter dem neueren Commit ist der erste Text-Commit ausgewählt; rechts erscheint der ursprüngliche Beitrag von 30 Euro.
KI-generierte Illustration: In der History lässt sich die frühere Änderung ansehen.

Damit hast du die aktuelle Datei nicht zurückgesetzt, sondern nur eine frühere Änderung angesehen. Um die alte Formulierung wieder zu verwenden, kannst du sie kopieren, in die aktuelle Datei einsetzen und mit einem neuen Commit festhalten. Die bisherige Geschichte bleibt dabei erhalten.

Git und GitHub sind nicht dasselbe

Bis hierhin liegt alles auf deinem Rechner. Git ist die Versionsverwaltung dahinter, GitHub Desktop die grafische Oberfläche, mit der du sie bedienst. Du hast nichts auf GitHub hochgeladen und keinen Account gebraucht.

GitHub ist dagegen ein Onlinedienst. Dort kannst du eine entfernte Kopie deines Repositories ablegen und sie mit anderen teilen. Dafür brauchst du einen Account; ein kostenloser reicht für den Einstieg. Andere Dienste für Git-Repositories sind zum Beispiel GitLab oder Codeberg.

Das mit deinem lokalen Repository verbundene entfernte Repository wird als Remote bezeichnet. Zwei weitere Begriffe beschreiben den Austausch damit:

Push lädt deine lokalen Commits zum entfernten Repository hoch. Das gewöhnliche Speichern einer Datei und auch ein lokaler Commit laden noch nichts hoch.

Pull holt Änderungen aus dem entfernten Repository und integriert sie in deinen lokalen Arbeitsstand. Dabei können Konflikte entstehen, wenn du und jemand anderes dieselbe Stelle unterschiedlich bearbeitet habt.

Schaubild: Links liegt das lokale Git-Repository auf deinem Rechner, rechts eine entfernte Kopie auf GitHub. Push führt nach rechts, Pull nach links. GitHub Desktop ist die lokale Oberfläche.
Push überträgt lokale Commits zu GitHub; Pull holt Änderungen zurück. Hier ist der neue Termin noch nicht hochgeladen.

Git funktioniert also auch ohne GitHub. In unserer lokalen Übung brauchten wir weder Push noch Pull. Das Teilen im Internet ist ein eigener, optionaler Schritt.

Bevor du etwas hochlädst, prüfe, wer das Repository sehen darf und welche Dateien du aufnimmst. Passwörter, private Schlüssel und vertrauliche Daten gehören nicht versehentlich hinein. Eine später gelöschte Datei kann weiterhin in älteren Commits enthalten sein. Auch Name und E-Mail-Adresse aus deinen Commits können für andere sichtbar werden.

Und noch eine Unterscheidung ist wichtig: Einen Text zu committen oder zu pushen veröffentlicht ihn nicht automatisch auf einer Website. Ob daraus eine neue Website-Version wird, hängt vom eingerichteten Veröffentlichungsprozess ab.

Gemeinsam arbeiten, ohne sich in die Quere zu kommen

Angenommen, jemand aus dem Verein möchte die Begrüßung neu formulieren. Gleichzeitig pflegst du die Termine. Dafür kann Git getrennte Arbeitswege verwalten. So ein Arbeitsweg heißt Branch.

Ein Branch ist keine zusätzliche Ordnerkopie, sondern ein eigener Entwicklungsweg in der Versionsgeschichte. Du kannst Änderungen dort vorbereiten, während der bisherige Stand auf einem anderen Branch bestehen bleibt. Später lassen sich die Änderungen zusammenführen. Das nennt Git Merge.

Schaubild: Nach einer gemeinsamen Commit-Geschichte verzweigen sich zwei Arbeitswege für Termine und Begrüßung. Ein Merge führt sie zusammen; beide Geschichten bleiben sichtbar.
Getrennte Arbeitswege lassen sich mit einem Merge zusammenführen.

Wenn ihr unterschiedliche Dateien oder getrennte Stellen bearbeitet, kann Git die Änderungen oft automatisch zusammenbringen. Wenn ihr dieselbe Textstelle verschieden umschreibt, braucht es möglicherweise eine Entscheidung von euch.

Ein solcher Konflikt bedeutet nicht, dass alles kaputt ist. Git kann nur nicht entscheiden, welche Formulierung gelten soll. Ihr schaut euch beide Vorschläge an, übernehmt einen davon oder schreibt eine gemeinsame Fassung. Danach wird das Ergebnis festgehalten.

Das ist ein guter nächster Schritt, aber keine Voraussetzung für deinen ersten Versuch. Schon ein Repository mit verständlichen Commits kann dir allein viel helfen.

Wann Git sinnvoll ist – und wann nicht

Git eignet sich besonders gut für Dateien, die aus lesbarem Text bestehen: Markdown, einfache Notizen, Website-Inhalte oder Konfigurationsdateien. Hier lassen sich Änderungen präzise vergleichen und oft auch automatisch zusammenführen.

Word-Dokumente, PDFs und Bilder kann Git ebenfalls aufbewahren. Die üblichen Git-Oberflächen können deren Inhalt aber meistens nicht sinnvoll zeilenweise vergleichen. Bei großen oder häufig geänderten Binärdateien wächst außerdem die gespeicherte Geschichte schnell. Git ist deshalb nicht automatisch die beste Ablage für deine Fotosammlung.

Wenn ihr hauptsächlich gemeinsam in Google Docs schreibt, ist die dort eingebaute Versionsgeschichte oft die einfachere Lösung. Git lohnt sich eher, wenn du Dateien in einem eigenen Projektordner verwalten möchtest und bewusst nachvollziehbare Zwischenstände brauchst.

Du musst dafür kein Programmierer werden. Für den Anfang reicht: verstehen, was ein Repository ist, Änderungen ansehen und sinnvolle Commits erstellen. Alles Weitere kann dazukommen, wenn du es tatsächlich brauchst.