Cómo crea artículos Fern
Fern es tu agente de documentación con IA que investiga, redacta y prepara artículos para tu centro de ayuda. Tú le das una indicación y ella se encarga del resto.
En esta guía se explica cómo funciona el proceso, qué fuentes utiliza Fern y cómo obtener los mejores resultados.
Cómo funciona
La creación de un artículo con Fern sigue este flujo de trabajo:
Dale una indicación a Fern - Ve a la página de Fern o pulsa ⌘K en cualquier página de Ferndesk. Escribe lo que necesitas (por ejemplo, "Documenta la funcionalidad de webhooks" o "Escribe una guía para configurar SSO").
Fern investiga - Analiza tu base de código, los tickets de soporte, los artículos existentes y cualquier archivo o enlace que proporciones. Verás un desglose de lo que está investigando.
Fern planifica el trabajo - Crea una lista de tareas que muestra cada paso (investigación, redacción y adición de elementos visuales). Esto te permite supervisar su progreso.
Fern prepara el borrador del artículo - Escribe el artículo completo basándose en su investigación. El borrador aparece en el visor de tareas con el estado "Listo para revisar".
Revisa y publica - Edita el borrador directamente en el visor de tareas y, cuando esté listo, publícalo en tu centro de ayuda.
Fern no publica automáticamente. Siempre tienes el control final antes de que los artículos se publiquen.
Qué fuentes utiliza Fern
Fern consulta varias fuentes para crear documentación precisa y completa:
Tu centro de ayuda - Busca artículos existentes para evitar duplicados y añadir enlaces relevantes
Conversaciones de soporte - Analiza tickets de Intercom, Zendesk o Help Scout para identificar preguntas frecuentes y puntos problemáticos
Tu base de código - Explora tus repositorios de GitHub conectados para documentar flujos de la interfaz, rutas, endpoints de API y mensajes de error. Si tienes varios repositorios conectados, Fern puede centrarse en un repositorio o una rama específicos cuando sea necesario.
Archivos y enlaces - Lee archivos PDF, archivos de texto y documentación externa que adjuntes a la indicación
Imágenes - Captura y anota capturas de pantalla y analiza diagramas (no puede generar ilustraciones originales; solo capturarlas y describirlas)
Videos - Inserta videos públicos de YouTube, Loom, Wistia o Vimeo. También puedes subir videos directamente.
Navegación web - Investiga documentación externa, registros de cambios o materiales de referencia
Conecta integraciones como GitHub e Intercom en la configuración de tu espacio de trabajo para dar acceso a Fern a estas fuentes.
Cómo obtener los mejores resultados
La calidad de los resultados de Fern depende de cuánto contexto proporciones. Así puedes prepararla para que tenga éxito:
Escribe indicaciones claras y detalladas
Especifica lo que quieres. En lugar de "Documenta los webhooks", prueba con "Documenta la funcionalidad de webhooks. Incluye los pasos de configuración, los eventos disponibles, el formato de la carga útil y la solución de errores comunes".
Cuantos más detalles proporciones, mejor podrá Fern investigar y estructurar el artículo.
Configura instrucciones globales
Ve a Settings → About you para configurar cómo escribe e investiga Fern:
Instrucciones de redacción - Define el tono que prefieres (por ejemplo, "Usa un tono seguro y cordial" o "Escribe para un público técnico")
Instrucciones de investigación - Indica a Fern qué debe priorizar (por ejemplo, "Explora siempre la base de código para revisar los flujos de la interfaz" o "Comprueba los tickets de soporte para detectar problemas comunes")
Esta configuración se aplica a todas las tareas que crea Fern, por lo que no tendrás que repetirla.
Adjunta archivos y enlaces
Si tienes materiales de referencia (documentos de especificaciones, capturas de pantalla, videos o documentación existente), adjúntalos directamente a tu indicación. Fern los incorporará a su investigación.
Usa borradores y auditorías automáticos de PR
Cuando Automatic PR drafts está activado, Fern puede crear borradores a partir de pull requests combinadas que cambien el comportamiento visible para los clientes. Sensitivity and Guidance for PR drafts en Settings > Automations controla con qué facilidad se crean esos borradores y qué reglas permanentes se aplican. No todas las PR combinadas se convierten en una tarea de redacción.
Fern también identifica brechas de documentación mediante auditorías. Visita la página de Fern para consultar los resultados de la auditoría y, después, asigna tareas directamente para preparar los artículos necesarios.
Trabajar con borradores
Cuando Fern termina, el borrador aparece en el visor de tareas. Puedes:
Editar directamente - Usa el editor integrado para perfeccionar el contenido, ajustar el formato o añadir secciones
Solicitar cambios - Envía un mensaje a Fern en el hilo de la tarea para pedir revisiones (por ejemplo, "Añade una sección de solución de problemas" o "Haz más corta la introducción")
Publicar cuando esté listo - Guarda y publica el artículo en la colección de tu centro de ayuda
Los borradores permanecen en el visor de tareas hasta que los publiques. Nada se publica sin tu aprobación.
Las tareas muy largas pueden mostrar un separador Context compacted en el hilo. Este comportamiento es automático y permite que la tarea siga ejecutándose. Puedes expandir el separador para revisar el resumen; el borrador continuará con normalidad.
Después de publicar
Fern solo publica contenido en el idioma principal. Si tienes activados idiomas de traducción administrados automáticamente, el conjunto de traducción pone en cola automáticamente las traducciones de los artículos recién publicados. Aparecen poco después de la publicación, no de inmediato. Para actualizar traducciones existentes, usa el selector de idioma del editor de artículos o ve a Help Center > Translate para volver a traducir todo el contenido de ese idioma.
Ejemplos de código en los borradores
Los borradores de Fern pueden incluir bloques de código con resaltado de sintaxis y bloques de código multilingües que muestran el mismo fragmento en varios lenguajes, lo que resulta útil para mostrar ejemplos de REST y SDK uno junto a otro. Mientras prepara el borrador, Fern también puede buscar en las referencias de API publicadas, de modo que los nombres de endpoints, métodos, parámetros y respuestas de las nuevas guías coincidan con tu especificación.