Usa esta plantilla
Los artículos de tipo “cómo hacer” son uno de los formatos de contenido con más tráfico en la web. Con Trupeer, puedes ahorrar horas en la redacción de contenido “cómo hacer” empezando con una plantilla gratuita de artículo “cómo hacer”, personalizándola con tus directrices de marca y convirtiendo cada artículo en un atractivo tutorial en vídeo que ofrece a los lectores una segunda forma de aprender.
Un artículo “cómo hacer” sitúa al lector en un estado muy concreto. Están a medio camino de algo, no funciona y ya han invertido más tiempo del que querían. No están leyendo: están escaneando para encontrar el fragmento que les desbloquea.
Casi todas las reglas sobre cómo escribir estos artículos se derivan de eso.
Descarga la plantilla de artículo “cómo hacer”
Formato | Mejor para |
|---|---|
Word (.docx) | Redactar y revisar antes de incorporarlo a tu centro de ayuda |
Guías imprimibles, paquetes de incorporación, consulta sin conexión | |
PowerPoint (.pptx) | Convertir un “cómo hacer” en un deck de formación o diapositivas de recorrido |
Google Docs | Redactar con la persona que realmente realiza la tarea |
Excel (.xlsx) | El inventario del artículo: título, responsable, última revisión, fuente |
Gratis, editable, sin marca de agua.
Las tres formas en que falla un artículo “cómo hacer”
Cada fallo es uno de estos, y requiere soluciones diferentes.
Puerta | La pregunta del lector | Qué lo soluciona |
|---|---|---|
Encontrarlo | ¿Existe un artículo sobre esto? | El título y dónde está indexado |
Confirmarlo | ¿Este es el artículo correcto para mi situación? | El bloque inicial y los requisitos previos |
Completarlo | ¿Puedo llegar realmente hasta el final? | Calidad de los pasos, capturas, solución de problemas |
La mayoría de los consejos de redacción se centran en la tercera puerta. La mayoría de los artículos fallan en las dos primeras.
Puerta uno: el título
Si el título no coincide con las palabras que usaría el lector, el artículo no existe para él.
Escribe la tarea, no la función. “Cómo exportar tu informe a CSV” supera a “Usar el módulo de exportación”. La gente busca lo que intenta hacer.
Usa su vocabulario. El nombre interno de una función no es como la llaman los clientes. Toma la redacción de los tickets de soporte y de la búsqueda del sitio.
Empieza con el verbo. “Cómo restablecer tu contraseña” se escanea más rápido que “Restablecimientos de contraseña: una guía”.
Sé lo bastante específico como para ser exclusivo. “Cómo añadir un usuario” es ambiguo si tienes tres tipos de usuario. “Cómo añadir un usuario administrador a un espacio de trabajo” no lo es.
Una tarea por título. Si el título contiene “y”, tienes dos artículos.
Puerta dos: el bloque inicial
El lector ya ha llegado. Tiene unos cinco segundos para decidir si esta es la página adecuada.
El bloque inicial responde a tres preguntas antes de que empiecen los pasos.
Qué hace este artículo. Una frase. “Este artículo te muestra cómo conectar tu sistema de contabilidad para que las facturas se sincronicen automáticamente”.
Para quién es. Cualquier rol, requisito de permisos o plan. “Necesitas acceso de administrador para hacerlo”.
Lo que necesitas primero. Requisitos previos, indicados antes del paso uno en lugar de descubrirse en el paso cuatro.
Ese último punto evita la frustración más común en la documentación técnica: que empieces con tres pasos y descubras que te falta algo. Los requisitos previos deben estar arriba, siempre.
Añade el tiempo estimado cuando supere un par de minutos. “Esto tarda unos 15 minutos” permite a alguien decidir si empezar ahora o volver más tarde.
Puerta tres: los pasos
Aquí es donde el lector termina o se rinde.
Una acción por paso. Si un paso contiene “y luego”, divídelo.
Empieza cada paso con el verbo. “Haz clic en Configuración” en lugar de “Luego deberías hacer clic en Configuración”.
Di dónde antes de qué. “En la parte superior derecha, haz clic en Exportar” les indica dónde mirar primero.
Nombra lo que verán. Etiquetas exactas de los botones, con la capitalización exacta. Si el botón dice “Guardar y cerrar”, escríbelo así.
Numéralos. Las viñetas implican que el orden no importa.
Mantenlo en menos de diez pasos cuando sea posible. Las tareas más largas se dividen en fases con subtítulos.
Muestra el resultado. Después del último paso, di qué debería ser cierto ahora. “La sincronización se ejecuta cada hora. Verás la última hora de sincronización en la página de integraciones”.
No expliques el porqué a mitad de la tarea. El lector está ejecutando, no aprendiendo. Pon el razonamiento en una nota o en un artículo conceptual separado.
Cómo personalizar esta plantilla en Trupeer
Paso 1: Abre la sección Plantillas
Ve a la sección Plantillas desde la navegación principal.
Paso 2: Selecciona y abre una plantilla
Haz clic en cualquier plantilla con la que quieras trabajar para abrirla.
Paso 3: Amplía la vista de la plantilla
Si es necesario, amplía la vista de la plantilla para ver el diseño completo y los detalles con claridad.
Paso 4: Edita la plantilla
Haz clic en Editar para empezar a modificar la plantilla seleccionada.
Dentro del editor, puedes:
Añadir nuevas secciones
Definir o actualizar reglas de formato
Añadir un logotipo y ajustar su posición y la configuración relacionada
Paso 5: Guarda tu plantilla personalizada
Después de realizar todos los cambios necesarios, haz clic en Guardar para almacenar la plantilla actualizada como tuya.
Paso 6: Previsualiza y ajusta la plantilla
Cuando quieras ver cómo se ve tu plantilla personalizada, abre la Previsualización.
Desde la pantalla de previsualización, puedes seguir haciendo ajustes directamente si es necesario, asegurándote de que la plantilla aparezca exactamente como la quieres.
Con una plantilla de artículo “cómo hacer” puedes:
Ahorra horas en la redacción: omite la página en blanco con una estructura creada para contenido “cómo hacer”.
Posiciona en búsqueda: los “cómo hacer” bien estructurados con el esquema HowTo se posicionan bien en Google.
Mantén la coherencia con tu marca: aplica tu logotipo, fuentes y colores usando el kit de marca de Trupeer.
Reduce la carga de soporte: los artículos “cómo hacer” claros ayudan a los usuarios a autoservirse.
Añade recorridos en vídeo: incrusta tutoriales en vídeo para los pasos que son difíciles de explicar en texto.
Llega a lectores globales: traduce artículos “cómo hacer” a 65+ idiomas con un solo clic.
La plantilla de artículo “cómo hacer”
Sección | Contenido |
|---|---|
Título | Basado en tareas, primero el verbo, una tarea |
Resumen | Una frase sobre lo que consigue |
Para quién es | Rol, permisos, plan |
Antes de empezar | Requisitos previos, acceso, información necesaria |
Tiempo requerido | Cuando supere un par de minutos |
Pasos | Numerados, una acción cada uno, con capturas |
Resultado | Qué debería ser cierto ahora |
Solución de problemas | Las tres o cuatro cosas que suelen salir mal |
Artículos relacionados | La siguiente tarea más probable y el artículo conceptual si existe |
Metadatos | Responsable, última revisión, versión del producto |
Diez secciones, de las cuales cuatro son breves. El grueso son los pasos y la solución de problemas.
Capturas
La diferencia entre un artículo “cómo hacer” útil y una pared de instrucciones.
Una captura por paso cuando la interfaz no sea evidente. No en todos los pasos, o el artículo dejará de poder escanearse.
Recorta el área relevante. Una captura a pantalla completa hace que el lector tenga que buscar lo que querías decir.
Anota con ligereza. Un recuadro o una flecha. Varias anotaciones compiten entre sí.
Muestra el estado, no solo la ubicación. Cuando un paso cambia algo, un antes y después vale más que una sola imagen.
Evita datos personales o de clientes. Usa una cuenta de demostración y revisa las pestañas del navegador y las notificaciones en la esquina de tu captura.
Ten en cuenta el coste de mantenimiento. Las capturas se quedan obsoletas con cada cambio de interfaz, y las capturas desactualizadas minan la confianza en todo el artículo. Este es el argumento más sólido para grabar en lugar de capturar.
Solución de problemas
La sección que separa un artículo competente de uno realmente útil, y la que más a menudo se omite.
Enumera las tres o cuatro cosas que realmente salen mal, con las palabras del lector, y la solución.
No aparece nada después del paso 4. Normalmente significa que la conexión no ha terminado de autorizarse. Espera un minuto y actualiza. Si sigue vacío, es posible que la cuenta no tenga el permiso necesario.
El botón está atenuado. Necesitas acceso de administrador para esto. Pídeselo a quien configuró tu espacio de trabajo.
Funcionó, pero los datos se ven mal. Revisa el filtro de rango de fechas, que se establece por defecto en el mes actual.
Obtén estas situaciones de tickets de soporte en lugar de la imaginación. Si cuatro personas te han contactado con el mismo problema después de seguir el artículo, ese problema pertenece al artículo.
Débil y mejor
Débil: Los usuarios pueden configurar la configuración de exportación a través del módulo de informes para obtener datos en varios formatos según sea necesario.
Mejor: Para exportar un informe a CSV: 1. Abre el informe. 2. En la parte superior derecha, haz clic en Exportar. 3. Elige CSV y haz clic en Descargar. El archivo aparece en tu carpeta de descargas e incluye todas las columnas visibles actualmente en el informe.
Débil: Paso 3: Configura la configuración de la integración de forma adecuada y guarda los cambios.
Mejor: 3. Introduce la clave de API desde tu sistema de contabilidad. 4. Establece la frecuencia de sincronización en Horaria. 5. Haz clic en Guardar y probar. Deberías ver una etiqueta verde de Conectado.
La primera versión es un solo paso que hace tres cosas sin forma de saber si funcionó. La segunda son tres pasos con un resultado verificable.
Título débil: Guía de configuración de la integración
Título mejor: Cómo conectar tu sistema de contabilidad
Apertura débil: Este artículo ofrece una visión general de la funcionalidad de exportación disponible dentro de la plataforma.
Apertura mejor: Te muestra cómo exportar un informe a CSV, Excel o PDF. Necesitas acceso de visualización al informe. Tarda aproximadamente un minuto.
Tipos de artículos de documentación
Un “cómo hacer” es uno de cuatro tipos, y mezclarlos es el error estructural más común en la documentación.
Tipo | Responde | Estado del lector | Formato |
|---|---|---|---|
Cómo hacer | ¿Cómo hago esta tarea específica? | Atascado, a mitad de la tarea, impaciente | Pasos numerados |
Concepto | Qué es esto y por qué funciona así | Aprendiendo, con tiempo | Prosa con ejemplos |
Referencia | Cuáles son los valores y opciones exactos | Buscar una cosa | Tablas y listas |
Tutorial | Enséñame esto desde cero | Nuevo, dispuesto a seguir | Secuencia guiada con un ejemplo resuelto |
El error es explicar conceptos dentro de un “cómo hacer”. El lector está ejecutando y no quiere el contexto. Enlaza el artículo conceptual en su lugar y mantén los pasos limpios.
El error inverso es un artículo conceptual con tres pasos escondidos en medio, que nadie encontrará cuando los necesite.
Longitud del artículo
Más corto de lo que sugiere el instinto. Un artículo “cómo hacer” debe cubrir una tarea y detenerse.
Si supera los diez pasos, busca una división natural. “Cómo configurar X” suele ser realmente “Cómo crear X”, “Cómo configurar X” y “Cómo invitar a personas a X”, que son tres artículos que pueden encontrarse de forma independiente y enlazarse en secuencia.
Los artículos largos también fallan en la puerta uno, porque un solo artículo que cubre seis tareas solo puede tener un título, lo que significa que cinco de esas tareas no se pueden encontrar.
Formatos
Word para redactar y revisar, porque los cambios controlados y los comentarios hacen que el ciclo de revisión sea manejable. Aquí es donde la mayoría de los artículos deberían escribirse antes de acercarse a cualquier sistema de publicación.
PDF para cualquier cosa impresa, entregada en formación o necesaria sin conexión. También es el formato adecuado para una guía orientada al cliente que adjuntas a un correo electrónico.
PowerPoint cuando un “cómo hacer” se convierte en formación. Un paso por diapositiva, una captura en cada una, funciona bien para una sesión de recorrido.
Tu centro de ayuda o base de conocimiento para cualquier contenido orientado al cliente que deba poder encontrarse y buscarse, que es la mayoría. Word y PDF son formatos de redacción y distribución, no de publicación.
Mantenimiento de artículos
La documentación se degrada en silencio, y la documentación desactualizada es peor que ninguna porque la gente la sigue y falla.
Asigna un responsable por artículo. Registra la versión del producto con la que se escribió. Revisa después de cada lanzamiento que afecte a la función y, si no, en un ciclo fijo.
La señal de mantenimiento más fiable es un ticket de soporte sobre algo que el artículo cubre. Eso significa que el artículo está mal o que está bien pero no se puede encontrar. Ambas cosas merecen arreglarse y ambas son invisibles a menos que alguien esté atento.
Las capturas son el elemento que más mantenimiento requiere, a mucha distancia, por lo que merece la pena tenerlo en cuenta al decidir cuántas usas y cómo las produces.
Cómo medir si funciona
Vistas, que te indican si se puede encontrar.
Tickets de soporte sobre el mismo tema después de la publicación. Deberían disminuir. Si no lo hacen, el artículo no funciona o no se puede encontrar.
Términos de búsqueda sin resultados, que muestran qué artículos faltan.
Tiempo en la página, interpretado con cuidado. Mucho tiempo puede significar que es exhaustivo o que confunde.
Comentarios del artículo, si tu centro de ayuda los ofrece, aunque normalmente las tasas de respuesta son bajas.
Derivación, es decir, personas que vieron el artículo y luego no contactaron con soporte.
El número único más útil es el volumen de soporte sobre el tema antes y después de la publicación. Todo lo demás es un indicador indirecto.
Cómo escribir un artículo “cómo hacer”
Descubre qué preguntan realmente las personas, a partir de tickets de soporte y la búsqueda del sitio. No adivines el tema.
Escribe primero el título, como una tarea en las palabras del lector. Si no puedes, el alcance no está claro.
Haz la tarea tú mismo mientras escribes, o mira a alguien haciéndola. Los artículos escritos de memoria omiten pasos.
Enumera los requisitos previos a medida que los encuentres.
Escribe una acción por paso, primero el verbo, con las etiquetas exactas de la interfaz.
Captura o registra mientras avanzas, no después de memoria.
Indica el resultado esperado.
Añade solución de problemas a partir de tickets reales.
Haz que alguien que no lo conoce lo siga sin ayuda. Cada pregunta que haga es un defecto.
Publica y luego observa el volumen de soporte sobre ese tema.
El paso nueve es la única prueba real. Un artículo revisado por alguien que ya conoce la tarea siempre se leerá bien.
Buenas prácticas
Títulos basados en tareas en el vocabulario del lector.
Requisitos previos antes del paso uno, siempre.
Una acción por paso, primero el verbo.
Etiquetas exactas de la interfaz, capitalización exacta.
Capturas recortadas y anotadas con ligereza.
Resultado esperado indicado después del último paso.
Solución de problemas basada en tickets reales.
Una tarea por artículo, menos de diez pasos.
Conceptos enlazados, no incrustados.
Probado por alguien que no ha hecho la tarea.
Errores comunes
Títulos nombrados según las funciones, no según las tareas.
Requisitos previos descubiertos en el paso cuatro.
Pasos que contienen tres acciones cada uno.
Instrucciones vagas como “configura la configuración de forma adecuada”.
Etiquetas de la interfaz parafraseadas en lugar de citadas.
Capturas a pantalla completa sin recorte.
Datos de clientes visibles en una captura.
Sin resultado esperado, así que el lector no puede saber si funcionó.
Sin sección de solución de problemas.
Conceptos explicados dentro de los pasos.
Seis tareas en un solo artículo, cinco de ellas no se pueden encontrar.
Escrito de memoria en lugar de hacerlo.
Revisado solo por personas que ya saben cómo.
Las capturas nunca se actualizan después de un cambio de interfaz.
Graba la tarea en lugar de escribirla desde la memoria
Abre la plantilla en Trupeer AI, aplica tu kit de marca para que los artículos coincidan con tu documentación y edita cualquier sección directamente. La configuración está en la guía de la plantilla.
Dos cosas hacen que los artículos “cómo hacer” sean caros. Escribir desde la memoria omite los pasos que realizas automáticamente, que es exactamente donde los lectores se atascan. Y las capturas tardan en producirse y se quedan obsoletas con cada cambio de interfaz, por eso tantos artículos muestran una versión del producto que ya no existe.
Grabar lo soluciona todo. Realiza la tarea una vez y Trupeer AI genera el artículo escrito con los pasos en el orden en que ocurrieron realmente y con capturas capturadas automáticamente, además de un recorrido en vídeo narrado desde la misma grabación. Cuando cambie la interfaz, vuelve a grabar en lugar de volver a capturar.
Tradúcelo a 65+ idiomas y mantén el conjunto en tu base de conocimiento para que los lectores lo encuentren.
Grábalo. Ponle tu marca. Tradúcelo. Trupeer it.
Preguntas frecuentes
¿Hay una plantilla gratuita de artículo “cómo hacer” en Word?
Sí. Word es el formato principal y el lugar adecuado para redactar, ya que la revisión con cambios controlados es más fácil allí que en un sistema de publicación. Incluye toda la estructura con indicaciones en cada sección. Descarga gratuita, sin registro, sin marca de agua.
¿Hay una plantilla de artículo en Word, gratis para descargar?
Sí, y funciona para cualquier artículo instructivo, no solo los de paso a paso. La estructura se mantiene para artículos de concepto, referencia y solución de problemas con un ajuste menor.
¿Hay una plantilla gratuita de artículo “cómo hacer” en PDF?
Sí, como formato de guía imprimible adecuado para entregar en formaciones, paquetes de incorporación y cualquier cosa que un cliente necesite sin conexión.
¿Hay una plantilla de artículo en PDF?
Sí, tanto una versión en blanco como un ejemplo completado para que puedas ver un artículo “cómo hacer” terminado antes de escribir el tuyo.
¿Hay una plantilla gratuita de artículo “cómo hacer” en PPT o PowerPoint?
Sí. La versión de PowerPoint convierte un “cómo hacer” en un recorrido de formación: un paso por diapositiva, con espacio para una captura en cada una. Funciona bien para una sesión en vivo y menos bien como material de referencia después, así que la mayoría de los equipos también necesita la versión de Word.
¿Puedo descargar una plantilla gratuita de artículo “cómo hacer”?
Sí, cada formato se puede descargar gratis sin necesidad de cuenta y sin atribución.
¿Cuál es la mejor plantilla gratuita de artículo “cómo hacer”?
La que incluye requisitos previos y solución de problemas. La mayoría de las plantillas te dan un título y pasos numerados, que es la parte fácil. Los lectores se rinden porque descubren un requisito previo que falta en el paso cuatro o se encuentran con un problema que el artículo no menciona, y esas dos secciones son las que lo evitan.
¿Qué es un artículo “cómo hacer”?
Un artículo instructivo breve que cubre una tarea específica, escrito para alguien que intenta hacerlo ahora mismo. Se diferencia de un tutorial, que enseña desde cero, y de un artículo de concepto, que explica cómo funciona algo.
¿Qué debe incluir un artículo “cómo hacer”?
Un título basado en tareas, un resumen de una frase, para quién es incluyendo cualquier permiso necesario, requisitos previos antes del paso uno, tiempo requerido, pasos numerados con una acción cada uno, el resultado esperado, solución de problemas para los tres o cuatro problemas comunes, artículos relacionados y metadatos que muestren el responsable y la fecha de última revisión.
¿Cómo se escribe un buen artículo “cómo hacer”?
Escribe el título como una tarea en las palabras del lector, haz la tarea tú mismo mientras escribes en lugar de trabajar desde la memoria, enumera los requisitos previos a medida que los encuentres, usa una acción por paso con etiquetas exactas de la interfaz, indica qué debería ser cierto al final y añade solución de problemas a partir de tickets de soporte reales. Luego, haz que alguien que no lo conoce lo siga sin ayuda.
¿Cuánto debe durar un artículo “cómo hacer”?
Una tarea, idealmente menos de diez pasos. Si dura más, normalmente son varias tareas que podrían encontrarse mejor como artículos separados enlazados en secuencia. Los artículos largos también fallan porque solo pueden tener un título, lo que hace que las otras tareas que contienen sean invisibles para la búsqueda.
¿Cuál es la diferencia entre un “cómo hacer” y un tutorial?
Un “cómo hacer” sirve para alguien que ya sabe lo que quiere y necesita los pasos específicos. Un tutorial enseña a un principiante, normalmente con un ejemplo resuelto y más explicación. El estado del lector es la diferencia: el lector de un “cómo hacer” está impaciente y a mitad de la tarea; el lector de un tutorial ha reservado tiempo para aprender.
¿Los artículos “cómo hacer” deben incluir capturas?
Para todo aquello donde la interfaz no sea evidente, sí: recortadas en el área relevante y con anotaciones ligeras. No en cada paso, o el artículo deja de poder escanearse. Ten en cuenta que las capturas son el elemento de documentación que más mantenimiento requiere y se quedan obsoletas con cada cambio de interfaz, por lo que merece la pena valorarlo antes de añadir doce.
¿Con qué frecuencia se deben revisar los artículos “cómo hacer”?
Después de cada lanzamiento que afecte a la función y, si no, en un ciclo fijo; normalmente cada seis a doce meses. El desencadenante más útil es un ticket de soporte sobre algo que el artículo ya cubre, lo que significa que está mal o que no se puede encontrar.
¿Puedo personalizar esta plantilla de artículo “cómo hacer”?
Sí, cada versión se puede editar completamente. Ajusta las secciones a tus estándares de documentación, aunque los requisitos previos y la solución de problemas son los dos que merece la pena conservar siempre, ya que abordan los dos puntos en los que los lectores abandonan con más frecuencia un artículo.
