From 46c76f2e22ae45e89d40eb927dd1e9156a14d66f Mon Sep 17 00:00:00 2001
From: Jean-Luc Makiola <business@jeanlucmakiola.de>
Date: Wed, 8 Apr 2026 20:37:53 +0200
Subject: [PATCH] Add initial docs with Git & Gitea setup guide

---
 README.md    |  7 ++++
 git-setup.md | 96 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 103 insertions(+)
 create mode 100644 README.md
 create mode 100644 git-setup.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e78281f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# THB Docs
+
+Dokumentation und Anleitungen für Tools und Workflows im Studium.
+
+## Inhalte
+
+- [Git & Gitea Setup](git-setup.md) - Git installieren, konfigurieren und mit Gitea verwenden
diff --git a/git-setup.md b/git-setup.md
new file mode 100644
index 0000000..721d4a7
--- /dev/null
+++ b/git-setup.md
@@ -0,0 +1,96 @@
+# Git & Gitea Setup
+
+## Git installieren
+
+**Linux (Arch):**
+```bash
+sudo pacman -S git
+```
+
+**Linux (Ubuntu/Debian):**
+```bash
+sudo apt install git
+```
+
+**macOS:**
+```bash
+brew install git
+```
+
+**Windows:**
+
+Installer von https://git-scm.com herunterladen und ausführen.
+
+## Git konfigurieren
+
+```bash
+git config --global user.name "Vorname Nachname"
+git config --global user.email "deine@email.de"
+```
+
+## Repository von Gitea klonen
+
+```bash
+git clone https://gitea.jeanlucmakiola.de/THB/<repo-name>.git
+cd <repo-name>
+```
+
+Beim ersten Mal wirst du nach deinen Gitea-Zugangsdaten gefragt.
+
+## Grundlegende Git-Befehle
+
+### Status prüfen
+
+```bash
+git status
+```
+
+### Änderungen stagen und committen
+
+```bash
+git add datei.java              # Einzelne Datei stagen
+git add .                       # Alles stagen
+git commit -m "Beschreibung"    # Commit erstellen
+```
+
+### Änderungen pushen/pullen
+
+```bash
+git push                        # Lokale Commits hochladen
+git pull                        # Änderungen vom Server holen
+```
+
+### Branches
+
+```bash
+git branch                      # Alle Branches anzeigen
+git checkout -b feature-xyz     # Neuen Branch erstellen und wechseln
+git checkout main               # Zu main wechseln
+git merge feature-xyz           # Branch in aktuellen mergen
+```
+
+## Typischer Workflow
+
+1. `git pull` - Neueste Änderungen holen
+2. Dateien bearbeiten
+3. `git add <dateien>` - Änderungen stagen
+4. `git commit -m "Was wurde gemacht"` - Commit erstellen
+5. `git push` - Hochladen
+
+## Häufige Probleme
+
+### Merge-Konflikte
+
+Wenn beim `git pull` Konflikte auftreten:
+
+1. Betroffene Dateien öffnen (Konfliktstellen sind mit `<<<<<<<`, `=======`, `>>>>>>>` markiert)
+2. Konflikte manuell auflösen
+3. `git add <datei>` und `git commit`
+
+### Falsche Zugangsdaten gespeichert
+
+```bash
+git config --global --unset credential.helper
+```
+
+Beim nächsten Push/Pull wirst du erneut gefragt.