update
This commit is contained in:
@@ -2,22 +2,40 @@
|
||||
|
||||
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 oder Verb im Infinitiv
|
||||
- Handlungen als Nominalstil mit Maustaste, Kommando oder Verb im Infinitiv
|
||||
- Ein Kommando steht wörtlich im Zitat und ist so aufrufbar
|
||||
|
||||
Richtig:
|
||||
```
|
||||
- Vollmodus öffnen
|
||||
- RMB auf Funktion
|
||||
- Feature öffnen
|
||||
- RMB auf die Funktion
|
||||
- Klick auf "Funktion entfernen"
|
||||
- Bestätigen
|
||||
- Funktion entfernt
|
||||
```
|
||||
Falsch: letzte Zeile `Klick zum entfernen` (Handlung statt Endzustand)
|
||||
|
||||
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:
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user