F13 OS Dokumentation – Review zu technischer Klarheit & redaktioneller Lesbarkeit
Beim Lesen der aktuellen F13-OS-Dokumentation sind mir einige Punkte aufgefallen, die inhaltlich oder redaktionell verbessert werden könnten. Das Feedback soll der besseren Nachvollziehbarkeit und Konsistenz der Doku dienen und erfolgt in Absprache mit David.
FAQs (redaktionell, minor)
-
„Was ist F13“ ist inkonsistent: vier Funktionen werden erwähnt, aber nur drei ausgeführt F13 bietet allgemein vier Funktionen: einen Chat-Bot, eine Rechercheassistenz zu landespolitischen Themen, sowie die Generierung von Zusammenfassungen. Bitte beachten Sie, dass die Ihnen zur Verfügung stehende Version von F13 möglicherweise nicht alle dieser Funktionen anbietet.
-
Mismatch zwischen den Benennungen hier und der Benennungen auf der „Funktionen von F13“ Page
Nutzen (redaktionell, minor)
-
Unvollständigen Satz korrigieren Leider gibt es aktuell noch keine Testinstanz, auf der F13 im Live-Betrieb getestet werden kann. Wir arbeiten daran.
- DieTesting kann bis dahin nur über die eigene Installation erfolgen.
Softwareachitektur
-
Begriffliche Konsistenz herstellen. Aktuell unterscheiden sich die Benennung zwischen Grafik und Text aber auch innerhalb des Texts (zB „Microservices“ <> „AI Plattform“ <> „F13-Core")
DoD
-
Begriffe und Funktionsangaben konsistent (Diagramm ↔️ Text) -
Redaktionelle Korrekturen umgesetzt und intern gegengelesen