Cómo usar Fern en los issues de Linear

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

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

Cómo funciona

Requisitos previos

• 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 con @ en los issues de Linear

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

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

2. En la descripción o los comentarios del issue, 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 pasos de resolución de problemas para este mensaje de error"

4. Envía tu comentario

   En unos segundos, Fern responderá para avisarte 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 que muestran los pensamientos 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 el contexto completo del issue.

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

2. Haz clic en el campo Assignee 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 agrega como responsable y Fern responde inmediatamente en el hilo del issue.

   

4. Fern procesará el issue completo (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/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 de nuevo a @Fern con @ con tu solicitud de seguimiento.

3. Fern reanuda el trabajo en la tarea de Ferndesk existente y aplica 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 ferndesk.com/app/tasks.

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

3. Revisa el contenido redactado para verificar su precisión e integridad.

4. Haz clic en Publish 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 crea artículos Fern