docs: erweitere Makefile-Dokumentation in README und start-local (MP-17) (#17)
Integriert umfassende Makefile-Referenz in die Haupt-Dokumentation für
bessere Auffindbarkeit und Developer Experience.
Änderungen:
- README.md: Erweitert "Makefile-Shortcuts" zu "Makefile-Befehle"
- Hinzugefügt: Wichtigste Development-Befehle (full-up, services-up, dev-up, test, health-check)
- Hinzugefügt: SSoT-Befehle (docker-sync, docker-compose-gen, docker-validate)
- Hinzugefügt: Link zur vollständigen Referenz in docker-development.md
- +20 Zeilen (Zeilen 292-319)
- docs/how-to/start-local.md: Neue Sektion "Weitere Makefile-Befehle"
- Hinzugefügt: Verweis auf `make help`
- Hinzugefügt: Link zu Docker Development Guide Makefile-Referenz
- +6 Zeilen (nach Zeile 39)
Kontext:
Diese Änderungen bauen auf der vollständigen Makefile-Dokumentation in
.junie/guidelines/technology-guides/docker/docker-development.md auf
(194 → 756 Zeilen, 50+ Befehle, erstellt am 2025-11-11).
Nutzen:
- Entwickler: Schnellerer Einstieg durch zentrale Übersicht
- Onboarding: Alle wichtigen Befehle auf einen Blick
- AI-Assistenten: Konsistente Command-Referenz
- Dokumentation: Verbesserte Navigation zwischen How-To-Guides und Referenz
Technische Details:
Das Makefile umfasst 10 Befehlskategorien:
1. Development Workflow (dev-up, dev-down, dev-restart, dev-logs, dev-info)
2. Layer-spezifisch (infrastructure-*, services-*, clients-*)
3. Full System (full-up, full-down, full-restart, full-logs)
4. Build (build, build-service, build-client)
5. Test (test, test-e2e)
6. Environment (env-setup, env-dev, env-prod, env-staging, env-test, validate)
7. SSoT (versions-show, versions-update, docker-sync, docker-compose-gen, docker-validate, hooks-install)
8. Production (prod-up, prod-down, prod-restart, prod-logs)
9. Monitoring (status, health-check, logs, shell)
10. Cleanup (clean, clean-all)
Related:
- Vorherige Commits: Makefile-Optimierung (425 Zeilen, strukturiert)
- Vorherige Commits: docker-development.md vollständige Aktualisierung
- Vorherige Commits: Port-Korrekturen (8080 → 8081)
Testing:
- ✅ make help zeigt alle Befehle korrekt an
- ✅ Links in Markdown funktionieren
- ✅ Dokumentation konsistent mit aktuellem Makefile
StefanMoCoAt
5cc1ee6e4d