Cómo usar Fern en los issues de Linear

Una vez que hayas conectado Linear a Ferndesk, puedes trabajar con Fern directamente desde tus issues de Linear.

Esto te permite crear tareas de documentación sin tener que cambiar entre herramientas. Simplemente @menciona o asigna los issues a Fern, y observa cómo se crean y ejecutan las tareas en tu cuenta de Ferndesk.

Cómo funciona

Prerrequisitos

• Espacio de trabajo de Linear conectado a Ferndesk a través de la página de Integraciones

• Acceso al espacio de trabajo de Linear donde está instalada la aplicación Ferndesk

Cómo @mencionar a Fern en los issues de Linear

La forma más rápida de poner a Fern a trabajar en una tarea de documentación es @mencionar a Fern directamente en un issue de Linear.

1. Abre un issue existente en Linear o crea uno nuevo en tu espacio de trabajo conectado.

2. En la descripción del issue o en los comentarios, escribe @Fern seguido de tu solicitud.

   

   Ejemplo: "@Fern documenta este nuevo endpoint de la API para desarrolladores"

   Fern aparecerá como un usuario mencionable en el menú desplegable de autocompletado.

3. Completa tu mensaje con instrucciones claras sobre qué documentación 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 permisos de usuario para incluir este nuevo rol"

   • "@Fern escribe los pasos de solución de problemas para este mensaje de error"

4. Envía tu comentario

   En unos segundos, Fern responderá informándote de que ha empezado a trabajar en la tarea.

5. Observa cómo aparecen las actualizaciones de progreso en Linear mientras Fern trabaja.

   Lo que verás: Actividades en hilo mostrando los razonamientos de Fern

Cómo asignar issues de Linear a Fern

Alternativamente, puedes asignar un issue de Linear completo a Fern, lo que activa automáticamente una tarea de documentación basada en todo el contexto del issue.

1. Abre el issue de Linear en el que quieres que trabaje Fern.

2. Haz clic en el campo Assignee (Responsable) en el encabezado del issue.

   Resultado esperado: Aparece un menú desplegable que muestra a los miembros del equipo y las integraciones.

3. Busca Fern en el menú desplegable de responsables y selecciónalo.

   Resultado esperado: Fern se añade como responsable y responde inmediatamente en el hilo del issue.

   

4. Fern procesará todo el issue (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 app.ferndesk.com/tasks.

Realizar solicitudes de seguimiento

Puedes continuar la conversación con Fern directamente en el hilo del issue de Linear para perfeccionar la documentación.

1. Añade un nuevo comentario en el mismo issue de Linear donde Fern está trabajando.

2. @menciona a @Fern de nuevo con tu solicitud de seguimiento.

3. Fern reanudará el trabajo en la tarea existente de Ferndesk y aplicará los cambios solicitados.

Revisar y publicar en Ferndesk

Después de que Fern complete el trabajo en Linear, revisarás y publicarás la documentación en tu cuenta de Ferndesk.

1. Haz clic en el enlace de Ferndesk en el mensaje de finalización de Fern en Linear, o navega a app.ferndesk.com/tasks.

2. Abre la tarea para revisar el trabajo de Fern.

3. Revisa el contenido redactado para verificar su exactitud e integridad.

4. Haz clic en Publish (Publicar) para añadir el artículo a tu centro de ayuda, o realiza ediciones adicionales si es necesario.

Qué sigue

• Uso de Tareas para crear y editar artículos

• Cómo enviar solicitudes de seguimiento a Fern

• Cómo crea Fern los artículos