Address workshop issues and expand challenge guidance

README.md

@@ -28,23 +28,29 @@ Basisrouten nach dem Start:
 - `http://localhost:8080/hints.html` -> Hint Cheatsheet
 - `http://localhost:8080/solutions.html` -> Musterloesungen
 
-## Voraussetzungen (WSL oder Linux)
+## Voraussetzungen (Linux / macOS / Windows WSL)
 
 1. Docker + Compose (`docker compose` oder `docker-compose`)
-2. Bei Windows: Docker Desktop + WSL Integration aktiv
-3. Optional fuer TLS-Challenges: `easy-rsa`, `openssl`, `wireshark`
+2. Optional fuer TLS-Challenges: `easy-rsa`, `openssl`, `wireshark`
+
+Plattformhinweise:
+
+- Linux: Docker Engine oder Docker Desktop
+- macOS: Docker Desktop
+- Windows: Docker Desktop + WSL Integration aktiv
+- macOS: falls `make` fehlt -> `xcode-select --install`
 
 ## Schnellstart
 
+### Linux / macOS
+
 ```bash
 ./scripts/bootstrap.sh
 ```
 
-### Start auf Windows
+### Windows (WSL)
 
-Empfohlen: ueber WSL starten (nicht nativ in PowerShell ohne WSL).
-
-Option A (WSL Terminal):
+Option A (im WSL-Terminal):
 
 ```bash
 ./scripts/bootstrap.sh
@@ -56,7 +62,7 @@ Option B (PowerShell Wrapper):
 ./scripts/workshop.ps1 -Action bootstrap
 ```
 
-Der PowerShell-Wrapper braucht kein `make` und ruft die Linux-Skripte direkt in WSL auf.
+Der PowerShell-Wrapper braucht kein `make` und ruft Linux-Skripte direkt in WSL auf.
 
 Falls PowerShell das Script blockiert:
 
@@ -64,12 +70,13 @@ Falls PowerShell das Script blockiert:
 Set-ExecutionPolicy -Scope Process Bypass
 ```
 
-Weitere Aktionen aus PowerShell:
+Weitere Aktionen in PowerShell:
 
 ```powershell
 ./scripts/workshop.ps1 -Action redeploy
 ./scripts/workshop.ps1 -Action proxy-reload
 ./scripts/workshop.ps1 -Action reset
+./scripts/workshop.ps1 -Action reset-hard
 ```
 
 Wenn mehrere Distros installiert sind:
@@ -78,23 +85,31 @@ Wenn mehrere Distros installiert sind:
 ./scripts/workshop.ps1 -Action bootstrap -Distro Ubuntu-24.04
 ```
 
-Der Script:
+Das Skript:
 
 - prueft Docker + Compose
 - erstellt `.env` aus `.env.example` (falls nicht vorhanden)
 - startet den Stack
 
+Hinweis zu Skriptnamen:
+
+- `scripts/bootstrap.sh` ist der empfohlene Einstieg
+- intern nutzt es `scripts/bootstrap-unix.sh`
+- `scripts/bootstrap-wsl.sh` existiert nur noch als Kompatibilitaets-Wrapper
+
 ## Neu deployen / resetten
 
 ```bash
 make redeploy
 make proxy-reload
 make reset
+make reset-hard
 ```
 
 - `redeploy`: build + restart aller Services
 - `proxy-reload`: nur Reverse Proxy restart
 - `reset`: Container/Netzwerk/Volumes aufraeumen
+- `reset-hard`: wie `reset`, plus lokale Git-Aenderungen verwerfen (falls Git-Repo)
 
 Hinweis: `make redeploy` startet zusaetzlich den Reverse Proxy neu, damit Nginx-Config-Aenderungen sicher aktiv sind.