# 🚀 Modul 02 – Erste Schritte

In diesem Modul legst du dein erstes Git-Repository an und machst deine ersten Commits. Du lernst die grundlegenden Befehle, die du täglich brauchst.

---

## Schritt 1 – Repository anlegen

Wechsle in einen neuen Ordner und initialisiere ein Git-Repository:

```bash
mkdir mein-projekt
cd mein-projekt
git init
```

```text
Initialized empty Git repository in /pfad/zu/mein-projekt/.git/
```

Git hat einen versteckten Ordner `.git/` angelegt. Dort speichert Git alles – lösche diesen Ordner nie manuell.

---

## Schritt 2 – Status prüfen

```bash
git status
```

```text
On branch main

No commits yet

nothing to commit (create/copy files and use "git add" to track)
```

`git status` ist dein wichtigster Befehl. Er zeigt immer, was gerade los ist.

---

## Schritt 3 – Erste Datei anlegen

Erstelle eine Datei:

```bash
echo "# Mein Projekt" > README.md
```

Prüfe den Status erneut:

```bash
git status
```

```text
On branch main

No commits yet

Untracked files:
  (use "git add <file>..." to include in what you will be committed)
        README.md

nothing added to commit but untracked files present (use "git add" to track)
```

`README.md` ist **untracked** – Git sieht sie, aber verfolgt sie noch nicht.

---

## Schritt 4 – Datei zur Staging Area hinzufügen

```bash
git add README.md
```

```bash
git status
```

```text
On branch main

No commits yet

Changes to be committed:
  (use "git rm --cached <file>..." to unstage)
        new file:   README.md
```

Die Datei ist jetzt **staged** – bereit für den nächsten Commit.

> **Tipp:** Mit `git add .` fügst du alle geänderten Dateien im aktuellen Ordner hinzu.

---

## Schritt 5 – Ersten Commit erstellen

```bash
git commit -m "chore: README hinzugefügt"
```

```text
[main (root-commit) a3f9c12] chore: README hinzugefügt
 1 file changed, 1 insertion(+)
 create mode 100644 README.md
```

Glückwunsch! Du hast deinen ersten Commit erstellt. Der Hash (`a3f9c12`) ist die eindeutige ID dieses Commits.

### Gute Commit-Nachrichten

Eine gute Commit-Nachricht beschreibt, **warum** eine Änderung gemacht wurde, nicht nur was:

| Schlecht ❌ | Gut ✅ |
|------------|--------|
| `änderungen` | `fix: Tippfehler in Einleitung behoben` |
| `update` | `feat: Kontaktformular hinzugefügt` |
| `asdf` | `docs: Installationsanleitung ergänzt` |

---

## Schritt 6 – Weitere Commits

Füge mehr Inhalt hinzu und erstelle weitere Commits:

```bash
echo "Dieses Projekt ist toll." >> README.md
git add README.md
git commit -m "docs: Beschreibung ergänzt"
```

```text
[main b7e2f45] docs: Beschreibung ergänzt
 1 file changed, 1 insertion(+)
```

---

## Schritt 7 – Commit-Historie ansehen

```bash
git log
```

```text
commit b7e2f45abc123def456abc789def012abc345def (HEAD -> main)
Author: Vorname Nachname <name@example.com>
Date:   Mon May 12 10:30:00 2025 +0200

    docs: Beschreibung ergänzt

commit a3f9c12def456abc789def012abc345def678abc
Author: Vorname Nachname <name@example.com>
Date:   Mon May 12 10:25:00 2025 +0200

    chore: README hinzugefügt
```

Für eine kompaktere Ansicht:

```bash
git log --oneline
```

```text
b7e2f45 docs: Beschreibung ergänzt
a3f9c12 chore: README hinzugefügt
```

> `HEAD -> main` zeigt dir, auf welchem Branch und Commit du gerade bist.

---

## Befehlsübersicht

| Befehl | Was er macht |
|--------|-------------|
| `git init` | Neues Repository anlegen |
| `git status` | Aktuellen Zustand anzeigen |
| `git add <datei>` | Datei zur Staging Area hinzufügen |
| `git add .` | Alle Änderungen stagen |
| `git commit -m "..."` | Commit mit Nachricht erstellen |
| `git log` | Vollständige Commit-Historie |
| `git log --oneline` | Kompakte Commit-Historie |

---

## 📝 Jetzt bist du dran!

Weiter zur [Aufgabe](aufgabe.md) – dort übst du alles selbst.

---

**Weiter geht's mit:** [03 – Branches](../03-branches/README.md)