All checks were successful
Build and Push Docker Images / verify-docs-sync (push) Successful in 9s
Build and Push Docker Images / build-backend (push) Successful in 14s
Build and Push Docker Images / build-frontend (push) Successful in 13s
Build and Push Docker Images / build-docs (push) Successful in 1m47s
1.8 KiB
1.8 KiB
FEDEO Funktionsdokumentation
Diese Dokumentation bildet alle Funktionen der Software zentral ab und ist für die Nutzung in der Nuxt-Content-Docs-Homepage vorbereitet.
Ziel
- Vollständige Übersicht über Funktionen in Backend, Web-Frontend und Mobile-App
- Nachvollziehbare Versionierung der Doku
- Einfache Aktualisierung bei Funktionsänderungen
Struktur
docs/funktionen/uebersicht.md: Fachliche Gesamtübersicht der Bereichedocs/funktionen/backend-api.md: Automatisch erzeugte API-Funktionslistedocs/funktionen/frontend-web.md: Automatisch erzeugte Seiten-/Funktionsliste des Web-Frontendsdocs/funktionen/mobile-app.md: Automatisch erzeugte Screens-/Funktionsliste der Mobile-Appdocs/versionen/docs-versionen.md: Versionierung der Dokumentationdocs/wartung/dokumentationsprozess.md: Prozess, damit die Doku dauerhaft aktuell bleibtdocs/scripts/sync-funktionsdoku.mjs: Skript zur automatischen Aktualisierung
Aktualisierung bei Funktionsänderungen
Bei jeder Funktionsänderung bitte ausführen:
node docs/scripts/sync-funktionsdoku.mjs
Danach:
- Änderungen in
docs/funktionen/*.mdprüfen - Falls nötig fachliche Texte in
docs/funktionen/uebersicht.mdergänzen - Eintrag in
docs/versionen/docs-versionen.mdergänzen - Alles gemeinsam committen
Verwendung mit Nuxt Content
Empfohlene Vorgehensweise:
docs/in das Content-Verzeichnis übernehmen (oder per Sync einbinden)- Navigation anhand der Ordner
funktionen,wartung,versionenaufbauen backend-api.md,frontend-web.md,mobile-app.mdals referenzierende Funktionskataloge einbinden
Hinweis
Die Dateien backend-api.md, frontend-web.md und mobile-app.md werden automatisch generiert. Manuelle Änderungen in diesen Dateien werden bei der nächsten Synchronisation überschrieben.