Comprobador de complejidad de instrucciones

Encuentra pasos que abarcan demasiado, usan palabras vagas u ocultan quién actúa.

Funciona en tu navegador
Sin subidas
Sin cuenta

Esta herramienta analiza texto en inglés.

Cargando tu herramienta del navegador…

Qué hace Comprobador de complejidad de instrucciones

Unas buenas instrucciones hacen una sola cosa por paso. Pega un procedimiento en inglés y se revisa cada paso en busca de lo que hace que la gente se pare y vuelva a leer: dos o más acciones en una línea, como select y click; condiciones que empiezan por if o unless; pasos que superan el límite de palabras; palabras vagas como simply, just o as needed, y voz pasiva.

Si el texto tiene un encabezado Procedure o Steps, solo se revisan los pasos que hay debajo. Si no, se revisa cada paso o frase. La valoración es “Baja” cuando no se marca ningún paso, “Moderada” cuando se marca menos de un tercio y “Alta” por encima de eso. Cada marca dice qué hacer, por ejemplo dividir en pasos separados o plantearse un paso de decisión aparte.

Ejemplo

Entrada

## 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.

Resultado

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

Cómo usar Comprobador de complejidad de instrucciones

Pega tu procedimiento, a ser posible con un encabezado Procedure encima de los pasos.
Ajusta “Marcar frases de más de” a tu límite de palabras para un paso.
Corrige cada paso que no esté marcado como “Sin problemas”, empezando por los que tienen más de una marca.

Conviene saber

Las acciones se detectan a partir de una lista fija de verbos de interfaz habituales. Los pasos que combinan verbos menos comunes, como pick o launch, pueden no marcarse como pasos con varias acciones.
Algunas palabras vagas tienen usos inofensivos. Just en just under 2 MB y some en some users también se marcan, así que usa tu criterio.
Las condiciones se marcan aunque sean la opción correcta. Un if corto al principio de un paso a menudo es más claro que un paso de decisión aparte.

Preguntas sobre Comprobador de complejidad de instrucciones

¿Cómo se escriben instrucciones claras paso a paso?

Empieza cada paso con un verbo, da una acción por paso, nombra el botón o el campo exacto y di qué debe ver quien lee después. Pon las condiciones primero, como en “Si ves un error”, y saca las explicaciones de los pasos a notas.

¿Por qué cada paso debe tener una sola acción?

La gente sigue las instrucciones alternando entre el documento y la pantalla. Con una acción por paso, puede volver a encontrar por dónde iba y, si algo falla, decir exactamente qué paso ha ido mal. Dos acciones en una línea es el motivo más habitual por el que se salta un paso.

¿Por qué evitar palabras como simply y just?

Le dicen a quien lee que un paso es fácil, lo que hace sentir culpable a cualquiera que se atasque, y no añaden nada a la instrucción. Quitarlas hace los pasos más cortos y neutros. Expresiones como as needed son peores, porque esconden una decisión que quien lee tiene que tomar.