Inkonsistenz in Dokumentation fällt niemandem auf. Bis jemand scheitert.
Schon im UI trägt derselbe Button an drei Stellen drei verschiedene Namen: „Speichern", „Sichern", „Save". Die Dokumentation erbt diese Verwirrung, statt sie aufzulösen. Das ist kein Stilproblem. Das ist ein Orientierungsproblem. User müssen selbst entscheiden, ob das dasselbe ist.
Aus der Praxis:
- ❌ „Klicken Sie auf ‚Speichern’." – „Bestätigen Sie mit ‚Sichern’." – „Drücken Sie ‚Save’."
- ❌ Eine Aktion wird im einen Topic als „Vorgang" bezeichnet, im nächsten als „Prozess", im dritten als „Schritt-für-Schritt-Anleitung".
- ❌ Screenshots zeigen mal die deutsche, mal die englische UI – je nachdem, welche Version beim Schreiben gerade offen war.
Das lässt sich lösen:
- ✅ UI-Bezeichnungen vereinheitlichen und in der Dokumentation übernehmen.
- ✅ Einen Begriff pro Konzept festlegen und in der gesamten Dokumentation durchhalten.
- ✅ Für jede Sprachversion der Dokumentation Screenshots aus der jeweiligen UI-Sprache verwenden.
Konsistenz ist nicht Kreativlosigkeit. Sie ist Respekt vor den Usern.
Wer konsequent dieselben Begriffe verwendet, schenkt Usern eine Gewissheit, die sich niemand erarbeiten muss: Was einmal stimmt, stimmt überall.