Cómo crea Fern los artículos
Fern es tu agente de documentación con IA que investiga, escribe y redacta artículos para tu centro de ayuda. Tú le das un prompt y ella se encarga del resto.
Esta guía cubre cómo funciona el proceso, qué fuentes usa Fern y cómo obtener los mejores resultados.
Cómo funciona
Crear un artículo con Fern sigue este flujo de trabajo:
Dale a Fern un prompt - Ve a la página de Fern o pulsa ⌘N en cualquier parte de Ferndesk. Escribe lo que necesitas (por ejemplo, "Documentar la función de webhooks" o "Escribe una guía para configurar SSO").
Fern investiga - Revisa tu base de código, los tickets de soporte, los artículos existentes y cualquier archivo o enlace que le proporciones. Verás un desglose de lo que está investigando.
Fern planifica el trabajo - Crea una lista de tareas con cada paso (investigación, redacción, añadir elementos visuales). Esto te da visibilidad sobre su progreso.
Fern redacta el 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".
Tú revisas y publicas - 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 hagan públicos.
Qué fuentes usa Fern
Fern toma información de varias fuentes para crear documentación precisa y completa:
Tu centro de ayuda - Busca en los 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 de fricción
Tu base de código - Recorre tus repositorios de GitHub conectados para documentar flujos de UI, 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 PDFs, archivos de texto y documentación externa que adjuntes al prompt
Imágenes - Analiza capturas de pantalla y diagramas (no puede generar imágenes, solo describirlas y contextualizarlas)
Vídeos - Inserta vídeos públicos de YouTube, Loom, Wistia o Vimeo. También puedes subir vídeos 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 a Fern acceso a estas fuentes.
Obtener los mejores resultados
La calidad del resultado de Fern depende de cuánto contexto proporciones. Así es como puedes prepararla para el éxito:
Escribe prompts claros y detallados
Sé específico sobre lo que quieres. En lugar de "Documentar webhooks", prueba con "Documenta la función de webhooks. Cubre los pasos de configuración, los eventos disponibles, el formato del payload y la solución de errores comunes."
Cuanto más detalle proporciones, mejor podrá Fern investigar y estructurar el artículo.
Define instrucciones globales
Ve a Configuración → Fern para configurar cómo Fern escribe e investiga:
Instrucciones de redacción - Define el tono que prefieres (por ejemplo, "Usa un tono seguro y cercano" o "Escribe para públicos técnicos")
Instrucciones de investigación - Indica a Fern qué priorizar (por ejemplo, "Busca siempre en la base de código los flujos de UI" o "Revisa los tickets de soporte para encontrar incidencias comunes")
Estos ajustes se aplican a cada tarea que crea Fern, así que no tienes que repetirte.
Adjunta archivos y enlaces
Si tienes materiales de referencia (documentos de especificación, capturas de pantalla, vídeos, documentación existente), adjúntalos directamente a tu prompt. Fern los incorporará en su investigación.
Usa borradores y auditorías automáticos de PR
Cuando Automatic PR drafts está habilitado, Fern puede redactar a partir de pull requests fusionadas que cambian el comportamiento orientado al cliente. 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 fusionadas se convierten en una tarea de redacción.
Fern también identifica lagunas de documentación mediante auditorías. Visita la página de Fern para ver los hallazgos de la auditoría y luego asigna tareas directamente para redactar 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
Pedir cambios - Envíale un mensaje a Fern en el hilo de la tarea para solicitar revisiones (por ejemplo, "Añade una sección de solución de problemas" o "Haz la introducción más corta")
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 hace público sin tu aprobación.
Las tareas muy largas pueden mostrar un divisor Context compacted en el hilo. Esto es un comportamiento automático que permite que la tarea siga ejecutándose. Puedes expandir el divisor para revisar el resumen y el borrador continúa con normalidad.
Después de publicar
Fern solo publica contenido en el idioma principal. Si tienes activados los idiomas con traducción gestionada automáticamente, la suite 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 y no al instante. Para actualizar traducciones existentes, 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.