Crear y editar artículos con Fern

Las tareas son la forma en que le indicas a Fern qué crear o actualizar en tu centro de ayuda. Fern se encarga de la investigación y la redacción; tú proporcionas las instrucciones y revisas los resultados.

Crear una tarea

1

Abrir el mensaje de la tarea

Ve a la página de Fern en la barra lateral de tu panel, o presiona ⌘N (Mac) o Ctrl+N (Windows/Linux) desde cualquier lugar de Ferndesk.

2

Escribe tus instrucciones

Describe en lenguaje sencillo lo que necesitas. Sé específico para obtener mejores resultados:

• "Escribe una guía de primeros pasos para usuarios nuevos"

• "Actualiza el artículo de autenticación de la API con el nuevo flujo de OAuth"

• "Crea documentación de solución de problemas para errores de inicio de sesión"

Haz clic en cualquier tarjeta de plantilla debajo del cuadro de mensaje para rellenar previamente solicitudes comunes.

3

Añadir contexto y archivos adjuntos

Cuanto más contexto proporciones, mejor será el resultado de Fern. Puedes adjuntar:

• Archivos: Imágenes (PNG, JPEG, GIF, WebP), videos (MP4, WebM, QuickTime) o documentos (PDF, TXT, DOC, XLS, CSV)

• Enlaces: Pega URLs externas o videos de YouTube para que Fern los consulte

• Referencias: Selecciona artículos, colecciones o hilos de soporte existentes para darle a Fern información de contexto

Arrastra y suelta archivos, pega capturas de pantalla o usa los botones de adjuntos en el diálogo de creación de tareas.

4

Enviar y seguir el progreso

Envía tu tarea y Fern comienza a investigar y redactar. La tarea aparece en tu feed de Fern, donde puedes supervisar el progreso. Las tareas con borradores no publicados muestran un icono de artículo que indica que están pendientes de revisión.

Hay tres formas de crear tareas:

• Desde la página de Fern: Usa los métodos anteriores para crear tareas directamente

• Desde las recomendaciones de auditoría: Cuando Fern identifica vacíos de contenido o artículos desactualizados en las auditorías, haz clic en "Crear borrador con Fern" para generar una tarea con contexto ya adjunto

• Desde las integraciones: Si has conectado Linear, crea tareas de documentación directamente desde los issues. Consulta Cómo usar Fern en issues de Linear.

Qué pueden hacer las tareas

Fern puede gestionar varios tipos de trabajo de documentación:

• Crear artículos nuevos desde cero según tu descripción

• Actualizar contenido existente para reflejar cambios del producto o corregir errores

• Investigar y redactar a partir de tendencias de soporte, recomendaciones o auditorías

• Editar para mayor claridad reescribiendo secciones o mejorando la estructura

• Crear y eliminar colecciones para reorganizar la estructura de tu centro de ayuda

• Crear secciones para pestañas de navegación de nivel superior

• Mover artículos y colecciones entre distintas ubicaciones

• Eliminar artículos y colecciones que estén desactualizados o ya no se necesiten

Qué no pueden hacer las tareas

• Responder preguntas sobre cómo usar Ferndesk: Encuentra las respuestas en el centro de ayuda en su lugar.

• Editar traducciones o gestionar contenido en idiomas que no sean el principal: Fern solo edita el idioma principal de tu centro de ayuda.

Revisar y publicar

Cuando Fern termina de redactar un artículo, aparece en la parte inferior del hilo de tu tarea. Puedes editar el borrador directamente en el hilo de la tarea antes de publicarlo.

• Si el resultado se ve bien: Haz clic en "Publicar cambios" para que se hagan efectivos en tu centro de ayuda. La publicación espera primero a que se complete cualquier guardado de borrador activo

• Si necesita cambios: Envía un mensaje a Fern con instrucciones adicionales (por ejemplo, "añade más ejemplos de código" o "haz que el tono sea menos técnico"), o edita el borrador directamente en el hilo de la tarea

• Si no lo quieres: Cierra o descarta la tarea

Después de publicar una tarea

Una vez que publicas una tarea, pasa a ser de solo lectura.

Esto es intencional. Las tareas publicadas se bloquean para que puedas revisar qué se cambió sin volver a editarlo por accidente.

Cómo hacer más cambios

Si necesitas actualizar contenido que ya se publicó mediante una tarea:

1. Ve a la página de Fern para iniciar una nueva tarea

2. Describe lo que quieres cambiar

3. Adjunta los mismos artículos o colecciones como referencias para que Fern tenga el contexto adecuado

La nueva tarea retomará el trabajo donde lo dejó la anterior, con acceso completo al estado actual de tu centro de ayuda.

Qué ocurre con las traducciones

Fern solo publica contenido en el idioma principal. Si tienes habilitados los idiomas de traducción gestionados automáticamente, la suite de traducción pone en cola automáticamente las traducciones de los artículos recién publicados. Las traducciones aparecen poco después de la publicación, no al instante. Si necesitas actualizar una traducción existente, usa el selector de idioma en el editor del artículo o ve a Help Center > Translate para volver a traducir todo el contenido de ese idioma.

Consejos para obtener mejores resultados

• Menciona artículos o colecciones con @ para indicarle a Fern que se enfoque en ellos

• Proporciona ejemplos: Si quieres un formato o estilo específico, incluye un ejemplo o toma como referencia un artículo similar

• Adjunta material de apoyo: Capturas de pantalla, documentos de especificaciones, ejemplos de respuestas de API: cualquier cosa que ayude a Fern a entender la función

• Vincula contenido relacionado: Haz referencia a artículos existentes para que Fern mantenga la coherencia con tu documentación actual

• Sé directo con el tono y la audiencia: Especifica si escribes para desarrolladores, usuarios finales, administradores, etc.

Problemas comunes

Recursos relacionados

• Cómo crea artículos Fern — Cómo funciona el proceso de investigación y redacción

• Buscar hilos en el espacio de trabajo de Fern — Encuentra tareas, auditorías y cambios de código anteriores

• Cómo audita Fern tu centro de ayuda — Cómo identifica Fern las lagunas de documentación

• Descripción general de la estructura del centro de ayuda — Comprende las secciones y colecciones