Cómo usar Fern en las incidencias de Linear
Después de conectar Linear con Ferndesk, puedes trabajar con Fern directamente desde tus incidencias de Linear.
Esto te permite crear tareas de documentación sin cambiar de una herramienta a otra. Solo tienes que mencionar con @ o asignar incidencias a Fern, y ver cómo se crean y ejecutan las tareas en tu cuenta de Ferndesk.
En esta guía se da por hecho que ya has conectado tu cuenta de Linear con Ferndesk.
Cómo funciona
Requisitos previos
Espacio de trabajo de Linear conectado a Ferndesk mediante la página de Integraciones
Acceso al espacio de trabajo de Linear donde está instalada la aplicación de Ferndesk
Si conectaste tu cuenta de Linear antes del 15 de septiembre, es posible que tengas que volver a instalar la aplicación de Linear.
Cómo mencionar a Fern en las incidencias de Linear
La forma más rápida de conseguir que Fern trabaje en una tarea de documentación es mencionar a Fern directamente en una incidencia de Linear.
Abre una incidencia de Linear existente o crea una nueva en tu espacio de trabajo conectado.
En la descripción o los comentarios de la incidencia, escribe
@Fernseguido de tu solicitud.
Ejemplo: "@Fern documenta este nuevo endpoint de API para desarrolladores"
Fern aparecerá como un usuario al que se puede mencionar en el menú desplegable de autocompletado.
Completa tu mensaje con instrucciones claras sobre la documentación que necesitas.
Ejemplos de solicitudes:
@Fern crea un artículo de ayuda que explique cómo configurar esta integración
@Fern actualiza el artículo existente sobre los permisos de usuario para incluir este nuevo rol
@Fern escribe los pasos para solucionar este mensaje de error
Envía tu comentario
En unos segundos, Fern responderá para informarte de que ha empezado a trabajar en la tarea.
Observa cómo aparecen las actualizaciones del progreso en Linear mientras Fern trabaja.
Lo que verás: Actividades agrupadas en hilos que muestran los razonamientos de Fern
Cuando Fern complete la tarea, recibirás una notificación de Fern con un enlace para ver los resultados en Ferndesk. Haz clic en el enlace para revisar y publicar la documentación.
Para obtener los mejores resultados, proporciona un contexto claro en tus incidencias de Linear antes de mencionar a Fern. El título, la descripción y los comentarios de la incidencia pasan a formar parte del contexto que Fern utiliza para crear la documentación.
Cómo asignar incidencias de Linear a Fern
Como alternativa, puedes asignar una incidencia completa de Linear a Fern, lo que activa automáticamente una tarea de documentación basada en todo el contexto de la incidencia.
Abre la incidencia de Linear en la que quieres que trabaje Fern.
Haz clic en el campo Persona asignada en el encabezado de la incidencia.
Resultado esperado: Aparece un menú desplegable que muestra los miembros del equipo y las integraciones.
Busca
Fernen el menú desplegable de personas asignadas y selecciónalo.Resultado esperado: Fern se añade como persona asignada y responde inmediatamente en el hilo de la incidencia.
Fern procesará toda la incidencia (título, descripción y comentarios) como contexto para crear la tarea de documentación.
En segundo plano, se creará automáticamente una nueva tarea en tu cuenta de Ferndesk en ferndesk.com/app/fern.
Cómo realizar solicitudes de seguimiento
Puedes continuar la conversación con Fern directamente en el hilo de la incidencia de Linear para perfeccionar la documentación.
Añade un comentario nuevo en la misma incidencia de Linear en la que está trabajando Fern.
Vuelve a mencionar a
@Ferncon tu solicitud de seguimiento.Si la tarea existente se puede volver a procesar, Fern reanudará el trabajo y aplicará los cambios solicitados. Si Fern ya está trabajando activamente en la tarea, responderá que ya está trabajando en ella en lugar de añadir la solicitud de seguimiento.
Las solicitudes de seguimiento deben publicarse en el mismo hilo de la incidencia de Linear. Crear una incidencia nueva iniciará una tarea de Ferndesk completamente nueva.
Revisar y publicar en Ferndesk
Después de que Fern termine el trabajo en Linear, revisarás y publicarás la documentación en tu cuenta de Ferndesk.
Haz clic en el enlace de Ferndesk incluido en el mensaje de finalización de Fern en Linear o ve a ferndesk.com/app/fern.
Abre la tarea para revisar el trabajo de Fern.
Revisa el contenido redactado para comprobar su exactitud y exhaustividad.
Haz clic en Publicar cambios para añadir el artículo a tu centro de ayuda o realiza ediciones adicionales si es necesario.