docs: Handbuch mit Bildern und Skript zum Auffrischen (#016)
Elf Kapitel von der Installation bis zur Fehlersuche, 16 Bilder. Das Skript meldet sich fuer die Aufnahmen selbst an, ohne Hintertuer im Code. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -1,8 +1,8 @@
|
||||
# #016 Benutzerhandbuch mit Screenshots
|
||||
**Status:** offen
|
||||
**Meilenstein:** v0.10.0
|
||||
**Status:** erledigt
|
||||
**Meilenstein:** v0.12.0
|
||||
**Labels:** docs
|
||||
**Geschätzt:** 5 h **Tatsächlich:** –
|
||||
**Geschätzt:** 5 h **Tatsächlich:** 0 h 30 min
|
||||
|
||||
## Ziel
|
||||
Bebildertes Handbuch auf Deutsch, das den kompletten Weg zeigt: Dashboard installieren, Enrollment-Token erzeugen,
|
||||
@@ -10,17 +10,17 @@ Agent auf einem Host ausrollen, Host einem Kunden zuweisen, Laufzeit und Rechnun
|
||||
Benachrichtigungen einrichten.
|
||||
|
||||
## Aufgaben
|
||||
- [ ] Gliederung `docs/anleitung/README.md` (Installation, Erste Schritte, Agent ausrollen, Kunden und Hosts, Rechnungen, Warnungen, Benachrichtigungen, Backup)
|
||||
- [ ] Screenshots automatisiert erzeugen (`npm run screenshots`): Seiten anfahren, Aufnahmen nach `docs/anleitung/bilder/` schreiben
|
||||
- [ ] Aufnahmen in Hell und Dunkel, dazu eine Mobilansicht
|
||||
- [ ] Bilder mit Bildunterschriften und Alternativtexten einbinden
|
||||
- [ ] Screenshots vor jedem Release auffrischen (Hinweis in der Release-Checkliste)
|
||||
- [ ] Verweise aus README und Dashboard-Hilfe auf das Handbuch
|
||||
- [x] Gliederung `docs/anleitung/README.md` (Installation, Erste Schritte, Agent ausrollen, Kunden und Hosts, Rechnungen, Warnungen, Benachrichtigungen, Backup)
|
||||
- [x] Screenshots automatisiert erzeugen (`npm run screenshots`): Seiten anfahren, Aufnahmen nach `docs/anleitung/bilder/` schreiben
|
||||
- [x] Aufnahmen in Hell und Dunkel, dazu eine Mobilansicht
|
||||
- [x] Bilder mit Bildunterschriften und Alternativtexten einbinden
|
||||
- [x] Screenshots vor jedem Release auffrischen (Hinweis in der Release-Checkliste)
|
||||
- [x] Verweise aus README und Dashboard-Hilfe auf das Handbuch
|
||||
|
||||
## Akzeptanzkriterien
|
||||
- [ ] Jemand ohne Vorkenntnisse kann anhand des Handbuchs Dashboard und Agent installieren
|
||||
- [ ] Jeder Arbeitsschritt hat mindestens ein Bild
|
||||
- [ ] Bilder zeigen Beispieldaten, keine echten Kundendaten
|
||||
- [x] Jemand ohne Vorkenntnisse kann anhand des Handbuchs Dashboard und Agent installieren
|
||||
- [x] Jeder Arbeitsschritt hat mindestens ein Bild
|
||||
- [x] Bilder zeigen Beispieldaten, keine echten Kundendaten
|
||||
|
||||
## Abhängigkeiten
|
||||
#014
|
||||
@@ -31,3 +31,9 @@ Benachrichtigungen einrichten.
|
||||
Das Profil braucht `user_pref("layout.css.prefers-color-scheme.content-override", 1);` für helle Aufnahmen und
|
||||
muss außerhalb versteckter Verzeichnisse liegen, sonst verweigert die Snap-Version den Zugriff.
|
||||
- Erste Aufnahmen des Prototyps liegen bereits in `docs/anleitung/bilder/`.
|
||||
- Das Handbuch liegt unter `docs/anleitung/README.md` mit elf Kapiteln und 16 Bildern.
|
||||
- `npm run screenshots -- --alle` erzeugt alle Bilder neu: Das Skript meldet sich selbst an, indem es ein
|
||||
Sitzungs-Cookie erzeugt und in ein eigenes Firefox-Profil schreibt. Der Schutz der Anwendung bleibt dabei
|
||||
unangetastet – es gibt keine Hintertür im Code.
|
||||
- Ein Kapitel „Fehlersuche“ nimmt die Fälle auf, die in der Praxis auftraten: stiller Agent, Anmeldung
|
||||
landet wieder auf der Anmeldeseite (falsche `APP_URL`), wiederkehrende Warnungen, geänderte Server-ID.
|
||||
|
||||
Reference in New Issue
Block a user