Dokumentation pflegen

Die Dokumentation liegt separat unter docs/astroguide. Während einer Dokumentationsänderung bleibt das Anwendungs-Repository projets/AstroGuide die faktische, nur lesbare Quelle.

Quellenpriorität

1. tatsächlicher Code, Ansichten, i18n-Katalog und Store;
2. aktuelle Compose-Datei, Dockerfile und nginx.conf;
3. README, DEMO.md, CONTRIBUTING.md und SECURITY.md;
4. ausführbare Tests;
5. Visionsdokumente nur als ausdrücklich benannte Zukunft, niemals als verfügbare Funktion.

Sprachvertrag

Englisch ist kanonisch und voreingestellt. Französisch, Spanisch und Deutsch sind gepflegte Übersetzungen, keine gekürzten Zusammenfassungen. Jede Seite muss in allen vier Sprachen vorliegen, technische Befehle und wissenschaftliche Vorbehalte erhalten und innerhalb derselben Sprache verlinken. Ändert sich eine Tatsache, müssen alle vier Fassungen in derselben Änderung aktualisiert werden.

Prüfungen vor der Auslieferung

npm ci
npm run lint
npm run typecheck
npm run check:content
npm run check:links
npm run build

Starte anschließend die Website und prüfe Suche, Sprachwechsel, sprachkonsistente Navigation, Tastatur, Theme sowie Desktop-, Tablet- und Mobilansichten. Versionsangaben und öffentliche URLs sind bei jeder Veröffentlichung neu zu bestätigen.