From 0c0f4cdf0f1df76e59cebdde87106757f37d3fb5 Mon Sep 17 00:00:00 2001
From: "daniel.appenmaier@gmail.com" <daniel.appenmaier@gmail.com>
Date: Thu, 25 Jun 2026 11:10:10 +0200
Subject: [PATCH] Small Fixes by Claude

---
 README.md                         | 59 ++++++++++++++++++++++++++++---
 docs/documentation/comparators.md |  2 +-
 docs/documentation/javafx.mdx     |  2 +-
 docs/documentation/lombok.mdx     |  4 +--
 4 files changed, 58 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index 41e8eed872..5c5c534fb3 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,56 @@
-# Java Docs
+# Programmieren mit Java
 
-Die aktuelle ☕-Dokumentation findet ihr unter
-[diesem Link](https://jappuccini.github.io/java-docs/production)🚀
+Deutschsprachige Java-Lerndokumentation, gebaut mit
+[Docusaurus 3](https://docusaurus.io/).
 
-Die Aufgaben und Lösungen findet ihr unter
-[diesem Link](https://github.com/jappuccini/java-exercises)🧑‍🎓
+- **Dokumentation & Übungsaufgaben:**
+  https://jappuccini.github.io/java-docs/production
+- **Aufgaben-Repository (Branches):**
+  https://github.com/jappuccini/java-exercises
+
+## Inhalt
+
+| Bereich                     | Beschreibung                                                           |
+| --------------------------- | ---------------------------------------------------------------------- |
+| `docs/documentation/`       | Java-Konzepte und Tutorials                                            |
+| `docs/exercises/`           | Übungsaufgaben (verlinken auf Branches in `jappuccini/java-exercises`) |
+| `docs/exam-exercises/`      | Klausuraufgaben                                                        |
+| `docs/additional-material/` | Tools, Einrichtungsanleitungen, Kursmaterialien                        |
+
+## Voraussetzungen
+
+- Node.js >= 22.0 (siehe `.nvmrc`)
+
+## Lokale Entwicklung
+
+```bash
+npm install       # Abhängigkeiten installieren
+npm start         # Entwicklungsserver starten (http://localhost:3000)
+```
+
+Änderungen an Dateien werden im Browser sofort sichtbar, ohne dass ein Neustart
+nötig ist.
+
+## Weitere Befehle
+
+```bash
+npm run build                                  # Produktions-Build erstellen
+npm run serve                                  # Build lokal ausliefern
+npm run clear                                  # Docusaurus-Cache leeren
+npm run prettier:check                         # Formatierung prüfen (läuft in CI)
+npx prettier . --write --end-of-line crlf      # Formatierung automatisch korrigieren
+```
+
+## Beitragen
+
+1. Branch von `main` erstellen
+2. Änderungen vornehmen
+3. Formatierung mit `npx prettier . --write --end-of-line crlf` sicherstellen
+4. Pull Request gegen `main` öffnen
+
+Die CI prüft beim Push auf `main` automatisch die Formatierung und deployt bei
+Erfolg auf GitHub Pages.
+
+## Autoren
+
+Daniel Appenmaier & Steffen Merk
diff --git a/docs/documentation/comparators.md b/docs/documentation/comparators.md
index 012170ddec..ce9f6b1fbc 100644
--- a/docs/documentation/comparators.md
+++ b/docs/documentation/comparators.md
@@ -37,7 +37,7 @@ public class NotebookByPowerInGhzComparator implements Comparator<Notebook> {
    ...
    @Override
    public int compare(Notebook o1, Notebook o2) {
-      return Integer.compare(o1.cpu().powerInGhz(), o2.cpu.powerInGhz());
+      return Integer.compare(o1.cpu().powerInGhz(), o2.cpu().powerInGhz());
    }
    ...
 }
diff --git a/docs/documentation/javafx.mdx b/docs/documentation/javafx.mdx
index 570e92f851..69e170eed6 100644
--- a/docs/documentation/javafx.mdx
+++ b/docs/documentation/javafx.mdx
@@ -188,7 +188,7 @@ public class OutputController implements Initializable {
       model = Model.getInstance();
 
       String value = model.getValue();
-      outputLabel.setText(value);
+      valueLabel.setText(value);
    }
 
 }
diff --git a/docs/documentation/lombok.mdx b/docs/documentation/lombok.mdx
index 23268630b7..398a8ad55e 100644
--- a/docs/documentation/lombok.mdx
+++ b/docs/documentation/lombok.mdx
@@ -60,11 +60,11 @@ public class MainClass {
 
    public static void main(String[] args) {
 
-      Student student1 = new Student("8172534", "Hans Maier");
+      Student student1 = new Student(8172534, "Hans Maier");
       student1.setAverageGrade(2.2);
       System.out.println(student1.getName());
 
-      Student student2 = new Student("9167121", "Lisa Müller", 1.8);
+      Student student2 = new Student(9167121, "Lisa Müller", 1.8);
       System.out.println(student2);
 
    }