Plantilla de artículos de resolución de problemas
por Atlassian
Documenta los problemas frecuentes y cómo resolverlos
Ayuda a tus clientes a resolver los problemas frecuentes y a dar con soluciones por su cuenta escribiéndoles artículos de resolución de problemas. Nuestra plantilla de artículos de resolución de problemas te brinda la estructura que necesitas para articular la incidencia, detallar la soluciones y mostrar artículos relacionados (algo que puedes hacer automáticamente mediante etiquetas y la macro de contenido por etiquetas para mantenerte al corriente de los artículos relacionados). Enséñales a pescar y consigue que tu equipo de soporte disponga de más tiempo para gestionar tareas más complejas.
Cómo usar la plantilla Artículo de resolución de problemas
Paso 1. Explica el problema
Con este tipo de artículos, zambullirte de lleno en la solución resulta tentador, pero explicar el problema constituye un componente de gran importancia a la hora de redactar contenido eficaz. Los lectores deben ser capaces de distinguir si tu artículo habla del problema al que se enfrentan. Piensa en cómo viven este problema los destinatarios de tu artículo y explica el problema empleando una terminología y unos ejemplos pertinentes para esas experiencias.
Paso 2. Ofrece una solución paso a paso
Una vez expuesto el problema, toca explicar cómo solucionarlo. Sírvete de una lista numerada para redactar una solución paso a paso. Debes utilizar términos que los lectores conozcan y entiendan, así como abordar los pasos uno por uno. Siempre que puedas, ilustra los pasos con imágenes. De este modo, quienes lean tu artículo sabrán cómo debería pintar la situación en cada paso del proceso. Si existe más de una posible solución, lo mejor que puedes hacer es ceñirte a escribir la más habitual. Si de verdad crees que tienes que ofrecer más opciones, puedes emplear una ampliación para crear un panel desplegable en el que añadir otras soluciones.
Paso 3. Muestra los artículos relacionados
En ocasiones, te toparás con un artículo sobre un problema parecido al tuyo, pero no exactamente igual. Y, a veces, tener más información sobre cómo funciona algo puede ayudarte a evitar problemas en el futuro. Si aplicas etiquetas a tus artículos de resolución de problemas y utilizas la macro de contenido por etiqueta (ya incluida en esta plantilla), podrás mostrar automáticamente artículos y páginas relacionados. Solo tendrás que cerciorarte de emplear la misma etiqueta en todas las páginas relacionadas.
Atlassian es una empresa de software empresarial que crea productos para desarrolladores de software, gestores de proyectos y gestión de contenidos.
Más plantillas de Desarrollo de software/TI Ver todo
-
Lucidchart
Diagrama de arquitectura de AWS
Visualiza tu infraestructura para identificar mejor sus puntos débiles y detectar áreas de mejora.
-
Atlassian
Diseña tu semana laboral ideal
Proporciona una guía paso a paso para completar una tarea.
-
Atlassian
Runbook de DevOps
Prepara a tu equipo de operaciones para que responda rápidamente a las alertas y las interrupciones del sistema.