Manual.md komplett neu: hochdetaillierte Referenz + PDF + Build-Pipeline
Manual.md ersetzt das bisherige kurze bilinguale Handbuch durch eine hochpräzise Anleitung: Kapitel 0-4/6-7 zitieren die tatsächlichen Tooltip-/Hilfetexte der App wörtlich (aus ConnectView, den Einrichten-Wizard-Schritten, DevicesView, BackupListView, OverviewView), Kapitel 5 (Experte-Feldreferenz, 44 Menüs/173 Felder) ist automatisiert aus RouterOSSchemaCatalog.swift geparst statt von Hand übertragen, kann also nie vom tatsächlichen App-Verhalten abweichen. Fünf Mermaid-Diagramme (Architektur, Verbindungs-/Vertrauens-Ablauf, Wizard-Schrittfolge, Fokus-Modus-Zustände, Sicherung/Wiederherstellung) als Quelle unter Manual-assets/diagrams/*.mmd, vorgerendert nach PNG. Echte App-Screenshots sind nicht möglich (keine macOS-UI-Automatisierung verfügbar) — im Manual selbst offen benannt statt stillschweigend ausgelassen. Neues build-manual.py regeneriert die Experte-Referenztabellen (zwischen festen Markern in Manual.md, Handschrift-Kapitel bleiben unberührt), rendert geänderte Diagramme neu und exportiert Manual.pdf über Markdown→HTML→headless Chrome print-to-pdf. README.md verweist auf beides. Künftig bei jeder Manual-Aktualisierung erneut laufen lassen, damit PDF und Referenztabellen nicht vom Quellcode abdriften. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
@@ -217,7 +217,10 @@ RouterOS/
|
||||
├── RouterOSAssistantTests/ — Unit-Tests (Command-Builder, CLI-Parser, ViewModels, Mock-Transport)
|
||||
├── project.yml — xcodegen-Projektdefinition (Quelle der Wahrheit, nicht das generierte .xcodeproj editieren)
|
||||
├── HANDOFF.md — detaillierter technischer Stand, alle gefundenen Bugs, offene Punkte
|
||||
└── CHATLOG.md — chronologischer Session-Verlauf
|
||||
├── CHATLOG.md — chronologischer Session-Verlauf
|
||||
├── Manual.md / Manual.pdf — Bedienungsanleitung (DE, Feldreferenz wörtlich aus RouterOSSchemaCatalog.swift extrahiert)
|
||||
├── Manual-assets/ — Mermaid-Diagramme fürs Manual (*.mmd Quellen unter diagrams/, gerenderte *.png)
|
||||
└── build-manual.py — regeneriert Manual.md-Feldreferenz + Diagramme + Manual.pdf (nach jeder Schema-/Manual-Änderung erneut laufen lassen)
|
||||
```
|
||||
|
||||
## Setup / Bauen
|
||||
|
||||
Reference in New Issue
Block a user