Polysh für Agenten ist im frühen Zugang. Ihr Coding-Agent nimmt die Demo auf, Polysh stellt sie fertig. Auf die Warteliste →

Anleitungs-Komplexitätsprüfer

Finden Sie Schritte, die zu viel bündeln, vage bleiben oder verschweigen, wer handelt.

Dieses Tool analysiert englischen Text.

Ihr Browser-Tool wird geladen…

Was Anleitungs-Komplexitätsprüfer macht

Gute Anleitungen tun eine Sache pro Schritt. Fügen Sie einen englischen Ablauf ein, und jeder Schritt wird auf die Probleme geprüft, bei denen Leser stocken und neu lesen: zwei oder mehr Aktionen wie select und click in einer Zeile, Bedingungen mit if oder unless, Schritte über dem Wortlimit, vage Wörter wie simply, just oder as needed und Passiv.

Hat der Text eine Überschrift Procedure oder Steps, werden nur die Schritte darunter geprüft. Andernfalls wird jeder Schritt oder Satz geprüft. Die Bewertung ist „Niedrig“, wenn kein Schritt markiert ist, „Mittel“, wenn es weniger als ein Drittel sind, und darüber „Hoch“. Jede Markierung sagt, was zu tun ist, etwa in einzelne Schritte aufteilen oder einen eigenen Entscheidungsschritt erwägen.

Beispiel

Eingabe

## Procedure
1. Open Users.
2. Select the account and click Reset MFA.
3. If the user is an admin, notify security.
4. Simply close the ticket.

Ergebnis

Complexity: High (3 of 4 steps need attention)
1. Clear
2. 2 actions (select, click), split into separate steps
3. Condition (if), consider a separate decision step
4. Vague or jargon words: simply

Anleitung: Anleitungs-Komplexitätsprüfer

  1. Fügen Sie Ihren Ablauf ein, am besten mit einer Überschrift Procedure über den Schritten.
  2. Setzen Sie „Sätze markieren über“ auf Ihr Wortlimit für einen Schritt.
  3. Korrigieren Sie jeden Schritt, der nicht als „Klar“ markiert ist, beginnend mit denen, die mehr als eine Markierung haben.

Gut zu wissen

  • Aktionen werden anhand einer festen Liste gängiger Verben aus Benutzeroberflächen erkannt. Schritte, die seltenere Verben wie pick oder launch kombinieren, werden eventuell nicht als Schritte mit mehreren Aktionen markiert.
  • Manche vagen Wörter haben harmlose Verwendungen. Just in just under 2 MB und some in some users werden ebenfalls markiert; urteilen Sie also selbst.
  • Bedingungen werden auch markiert, wenn sie die richtige Wahl sind. Ein kurzes if am Anfang eines Schritts ist oft klarer als ein eigener Entscheidungsschritt.

Fragen zu Anleitungs-Komplexitätsprüfer

Wie schreibt man klare Schritt-für-Schritt-Anleitungen?

Beginnen Sie jeden Schritt mit einem Verb, geben Sie eine Aktion pro Schritt vor, nennen Sie den genauen Button oder das genaue Feld und sagen Sie, was der Leser danach sehen sollte. Stellen Sie Bedingungen an den Anfang, etwa „Wenn Sie einen Fehler sehen“, und verschieben Sie Erklärungen aus den Schritten in Hinweise.

Warum sollte jeder Schritt nur eine Aktion haben?

Leser befolgen Anleitungen, indem sie zwischen Dokument und Bildschirm wechseln. Mit einer Aktion pro Schritt finden sie ihre Stelle wieder, und wenn etwas fehlschlägt, können sie genau sagen, welcher Schritt schiefgegangen ist. Zwei Aktionen in einer Zeile sind der häufigste Grund, warum ein Schritt übersprungen wird.

Warum sollte man Wörter wie simply und just vermeiden?

Sie sagen Lesern, dass ein Schritt leicht ist, wodurch sich jeder, der hängen bleibt, schuldig fühlt, und sie fügen der Anweisung nichts hinzu. Ohne sie werden Schritte kürzer und neutraler. Wendungen wie as needed sind noch schlimmer, weil sie eine Entscheidung verstecken, die der Leser treffen muss.