Files
planer2/backend/stil/funktion-testen.md
2026-09-07 07:44:00 +02:00

48 lines
1.6 KiB
Markdown

## Testen einer Funktion
Feld `testen`. Gibt es nur bei Funktionen, nie auf Kartenebene.
Pflicht bei jeder Funktion. Eine Funktion ist etwas, das man für sich testen kann —
ohne Ablauf ist sie nur eine Behauptung. Ziel und Regeln dürfen fehlen, Testen nie.
Weiß man den Ablauf nicht, ist es keine Funktion, sondern eine offene Frage.
- Eine Zeile je Schritt
- Genau ein Ablauf: handeln, handeln, Ergebnis
- Nach dem Ergebnis folgt keine Handlung mehr
- Schritte in Reihenfolge der Bedienung
- Beginnt mit der Vorbedingung, wenn eine nötig ist
- Kein Schritt der Bedienung fehlt
- Jeder Schritt ist ohne Vorwissen ausführbar
- Letzte Zeile beschreibt den Endzustand, keine Handlung
- Handlungen als Nominalstil mit Maustaste, Kommando oder Verb im Infinitiv
- Ein Kommando steht wörtlich im Zitat und ist so aufrufbar
Richtig:
```
- Feature öffnen
- RMB auf die Funktion
- Klick auf "Funktion entfernen"
- Bestätigen
- Funktion entfernt
```
Auf der Kommandozeile gilt dasselbe — der Aufruf ist die Handlung:
```
- Befehl "make install" ausführen
- Abmelden und wieder anmelden
- Anwendung läuft automatisch
```
Falsch: `Installationsskript starten` (sagt nicht, wie)
Falsch: `Der Prüfschritt kopiert die Desktop-Datei` (Bauweise statt Bedienung)
Falsch: letzte Zeile `Klick zum Entfernen` (Handlung statt Endzustand)
Falsch: `Funktion entfernen wählen` (sagt nicht, wo)
Falsch, weil zwei Abläufe in einer Funktion stehen:
```
- Klick auf Miniaturbild
- Großansicht öffnet und schließt
- Option aus Großansicht auswählbar
```
Jede Zeile ist hier ein eigenes Ergebnis, kein Schritt eines Durchlaufs. Solche
Funktionen sind mehrere und gehören getrennt.