contacara

Cómo escribir instrucciones claras que permitan completar una tarea

Explica quién puede empezar, qué debe preparar, qué acción debe realizar y cómo sabrá que ha terminado. Coloca cada condición antes del paso al que afecta y separa las alternativas. Después comprueba el recorrido en el servicio real: que el texto sea fácil de leer no demuestra que las instrucciones funcionen.

Define el resultado y los requisitos para empezar

Empieza por una tarea reconocible. Reservar una sala para una reunión no equivale a solicitar autorización para un evento. Si el servicio separa ambos trámites, no los agrupes bajo una palabra ambigua como «solicitud». La persona necesita saber si está en el recorrido adecuado antes de dedicarle tiempo.

Indica los requisitos que pueden impedir completar la tarea: permisos de acceso, credenciales, documentos o datos. Comprueba cuáles son obligatorios; no los inventes para rellenar una plantilla. Descubrir una condición al final puede inutilizar el trabajo anterior.

Esta guía utiliza un servicio ficticio de reserva de material de laboratorio. Sirve para revisar la escritura y no describe un portal existente. Para aplicar el ejemplo a un servicio real, habrá que comprobar sus controles, reglas, mensajes y resultados en el entorno correspondiente.

Redacta cada paso alrededor de una acción observable

Un paso útil contiene un verbo y un objeto identificable. «Rellena todo correctamente» no explica qué hacer. «Indica la fecha de recogida y el número de kits» señala dos datos concretos. Pueden compartir un paso si se introducen juntos; si exigen pantallas distintas, sepáralos.

Designers Italia recomienda textos de interfaz específicos, contextuales y orientados al objetivo. Utiliza las etiquetas que la persona verá. Si un botón dice «Enviar solicitud», llamarlo después «Confirmar pedido» puede sugerir un resultado diferente.

No orientes únicamente mediante el color o la posición. «Pulsa el botón verde de la derecha» pierde utilidad cuando cambia el diseño. Nombra la acción y añade la ubicación solo si ayuda. Una imagen debe mostrar el paso correcto y aportar información que el texto no explica por sí solo.

Detecta los vacíos de una explicación breve

Accede al servicio y rellena el formulario. Al terminar, confirma. Si hay problemas, comprueba los datos y vuelve a intentarlo. Los kits especiales pueden requerir autorización. La solicitud se tramitará lo antes posible.

El texto es corto, pero deja sin resolver qué preparar, cuándo obtener la autorización y cómo reconocer que el envío ha funcionado. «Confirma» puede significar revisar los datos o completar la reserva. «Vuelve a intentarlo» no distingue un error corregible de una solicitud ya recibida.

Antes de reescribir, reconstruye el procedimiento. Supongamos, para este caso ficticio, que los kits especiales necesitan un código, que existe un resumen antes del envío y que la recepción genera un número de solicitud. Son condiciones del ejemplo, no funciones comprobadas en un producto real.

Cuatro acciones vinculan materiales, cumplimentación, revisión y envío con resultados observables. El número de solicitud confirma recepción, no aprobación.
Esquema del taller ficticio. Las funciones deben comprobarse en un servicio real. Abrir el JPG a tamaño completo

Ordena las condiciones, las acciones y la confirmación

Antes de empezar, prepara la fecha de recogida y la cantidad. Si necesitas un kit especial, consigue también el código de autorización del laboratorio ficticio. Esa condición debe aparecer antes del envío, no escondida en una nota final.

  1. Accede al servicio de reservas y abre Nueva solicitud.
  2. Selecciona el tipo de kit e indica la cantidad y la fecha de recogida.
  3. Si es un kit especial, introduce el código de autorización en su campo.
  4. Abre el resumen. Comprueba el tipo, la cantidad y la fecha; corrige los errores antes de continuar.
  5. Si los datos son correctos, selecciona Enviar solicitud.
  6. Guarda el número que aparece en la confirmación de recepción.

No describas la recepción como aprobación si todavía hay una evaluación pendiente. Una instrucción real debe explicar cómo llegará la decisión y dónde consultar si falta la confirmación. Verifica esos datos; no los deduzcas del nombre del botón.

Ofrece una solución adecuada para cada error

«Algo ha fallado» aporta poco cuando la persona puede corregir el problema. Si falta un código, señala el campo. Si no es válido, explica cómo comprobarlo o a quién consultar. Si el servicio está caído, pedir que se modifiquen datos correctos no ayuda.

Designers Italia propone explicar el problema y la solución sin culpar a la persona. «Introduce el código de autorización para solicitar este kit» resulta más útil que «Has rellenado mal el formulario», siempre que el sistema pueda identificar esa causa.

También debes prever la duda sobre el envío. Si no aparece el número, explica cómo consultar el estado antes de repetir la solicitud. «Pulsa otra vez» no es una solución universal: comprueba qué acciones se pueden deshacer y cuáles podrían producir un segundo envío.

Haz visibles las alternativas sin interrumpir cada paso

Coloca las excepciones junto al punto que modifican. «Si solicitas un kit especial» debe preceder al código, sin repetirse entre paréntesis en todos los pasos. Si la alternativa es larga, puede tener una sección propia con un criterio claro para elegirla.

Utiliza números para las acciones sucesivas y viñetas para los materiales sin orden. Un título como «Después del envío» permite localizar la confirmación mejor que «Otra información».

El análisis de legibilidad puede orientar la revisión lingüística, pero el índice Gulpease está pensado para el italiano. No comprueba los requisitos ni el funcionamiento de un servicio. Incluso un texto con frases cortas falla si omite un documento imprescindible. Revisa por separado la redacción y la ejecución.

Comprueba el recorrido y registra lo que observas

En un servicio real, observa a una persona del público destinatario que empiece con los requisitos indicados e intente terminar sin explicaciones adicionales. Anota dónde intervienes y qué pregunta surge. No atribuyas la dificultad automáticamente a una lectura distraída: puede faltar información o diferir la etiqueta de la interfaz.

Comprueba el recorrido ordinario y las alternativas descritas. Registra como no verificado lo que no se haya probado. Revisar la redacción no demuestra que se haya enviado una solicitud, que la interfaz sea accesible o que funcione la recuperación de errores.

Cuando cambie el servicio, revisa los nombres, las condiciones, las imágenes y el resultado final. Una fecha de revisión debe corresponder a controles reales. La finalidad es que las instrucciones sigan prometiendo lo que el servicio permite hacer.

El recorrido completo del ejemplo ficticio

MomentoInformación necesariaSeñal de finalización
Antes de empezarFecha, cantidad y posible autorizaciónDatos preparados
FormularioAcciones y campos reconociblesDatos presentes en el resumen
RevisiónQué comprobar y corregirResumen coherente
EnvíoAcción con un efecto explícitoNúmero de solicitud
Después del envíoRecepción distinta de la decisiónEstado consultable según las reglas del servicio
Esquema original de redacción. Las funciones del laboratorio son hipotéticas y tendrían que comprobarse en un servicio real.

Fuentes y comprobaciones

  • Designers Italia: microtesti · Acciones específicas, ayuda contextual y mensajes de error que explican el problema y su solución sin culpar a la persona.

Abrir la herramienta en italiano