Dokumentation & README
Wenn eine Änderung sich darauf auswirkt, wie jemand das Projekt installiert, ausführt, konfiguriert oder verwendet, aktualisiere die README.md in derselben Änderung.
Die README sollte kurz abdecken:
- Was das Projekt ist (1-2 Sätze).
- Voraussetzungen und Installationsschritte.
- Wie man ausführt, testet und baut – kopierbare Befehle.
- Konfiguration: jede Umgebungsvariable mit Zweck und Beispielwert (niemals echte Geheimnisse).
- Kurze Nutzungsbeispiele für Hauptfunktionen.
Regeln:
- Bearbeite nur die Abschnitte, die von der Änderung betroffen sind; schreibe nicht die gesamte Datei neu.
- Überprüfe, ob jeder dokumentierte Befehl tatsächlich funktioniert.
- Englisch, kurze Sätze, keine Marketingsprache.