Español · How-to guide

Una guía práctica en español que se puede seguir de verdad

La escritura instructiva tiene una sola medida de calidad: si el lector puede hacerlo después. Todo lo demás se deriva de eso.

Empieza por el punto de partida del lector

Escribe tres cosas y tenlas delante: qué sabe hacer ya, qué tiene a mano y cómo es "terminado" —un resultado concreto, no una sensación—. "Un pan con miga abierta", no "confianza para hornear".

Analiza la tarea antes de escribir

Lista todas las acciones en orden, incluidas las demasiado obvias: ahí es donde se atasca el principiante. Para cada una anota qué hace falta antes, qué hace, cómo sabe que salió bien y qué suele fallar.

Cómo se escribe un paso

• Una acción por paso. Si lleva "y", probablemente son dos.
• Empieza por el verbo: "Abre el archivo", no "Vas a querer abrir el archivo".
• La condición primero: "Si la masa se pega, añade harina".
• Di qué debería estar viendo. Sin comprobaciones, quien falló en el paso cuatro lo descubre en el diecinueve.
• Pon el fallo junto al paso, no en un apéndice final que nadie lee a tiempo.

Verifica todo lo específico

Un modelo describe con absoluta seguridad un menú que no existe. Comprueba nombres de botones, versiones, precios y límites legales contra la cosa real. Si la guía toca electricidad, gas, comida, medicación o dinero, que la lea alguien competente antes de publicar.

Pruébala con una persona

La única comprobación real es ver a alguien seguirla sin tu ayuda. Tres lectores del público objetivo encuentran casi todo: donde dudan, el paso es ambiguo; donde retroceden, cambiaste el orden; lo que preguntan, se convierte en texto en ese paso.

Preguntas frecuentes