Ferndesk
Auditorías y automatización

Borradores automáticos de PR

Los borradores automáticos de PR mantienen tu documentación sincronizada con tu producto. Cuando un pull request fusionado cambia el comportamiento visible para el cliente, Fern lo detecta y crea automáticamente un borrador de actualización de la documentación.

Esta función conecta tu integración de GitHub con Fern, para que las actualizaciones de la documentación se realicen sin supervisión manual. Aun así, revisas y apruebas cada borrador antes de que se publique.

Cómo funciona

Cuando activas los borradores automáticos de PR, Fern supervisa los pull requests fusionados en tus repositorios de GitHub conectados. Si una fusión cambia algo que tus clientes necesitan saber, Fern crea un borrador de artículo o de actualización automáticamente.

El borrador aparece en tu página de Fern como un hilo con un icono de pull request. Lo revisas, haces ediciones si hace falta y lo publicas cuando esté listo. Fern nunca lo publica automáticamente.

Si tienes varios repositorios conectados, Fern puede limitar su análisis al repositorio donde se produjo la fusión. Para cambios específicos de una rama, Fern también puede examinar la rama concreta para entender qué cambió antes de redactar la actualización.

Requisitos previos

  • Integración de GitHub conectada - Fern necesita acceso a tus repositorios para supervisar los pull requests. Si aún no has conectado GitHub, primero configura la integración.

Activar los borradores automáticos de PR

1

Go to Settings

Abre Settings desde la barra lateral de tu panel de Ferndesk.

2

Open Automations

Haz clic en Automations en la barra lateral de configuración. Esta página muestra tanto los borradores automáticos de PR como la configuración de auditorías programadas.

3

Enable the toggle

Activa Automatic PR drafts. La configuración se guarda de inmediato y verás un mensaje de confirmación.

Una vez activado, Fern empieza a supervisar los pull requests fusionados en busca de cambios visibles para el cliente.

Qué activa un borrador

Fern crea un borrador de actualización cuando:

  • Un pull request se fusiona en uno de tus repositorios de GitHub conectados

  • La fusión incluye cambios en el comportamiento visible para el cliente (flujos de la UI, endpoints de la API, comportamiento de funciones, mensajes de error u opciones de configuración)

Fern analiza el diff para determinar si la documentación necesita actualizarse. Si el cambio es interno o no afecta a los clientes, Fern marca el hilo como "No documentation changes needed" y no creará un borrador.

Puedes ver ejecuciones en las que Fern no creó borradores filtrando por Automations en la página de Fern.

Revisar tus borradores

Cuando Fern crea un borrador, aparece en tu página de Fern como un hilo con un icono de pull request. El hilo muestra:

  • El título del PR y sus metadatos

  • Un resumen de lo que cambió

  • El estado del borrador (working, ready to review, or error)

Haz clic en el hilo para abrir el panel de detalles. Cuando el borrador esté listo, haz clic en Review & edit changes para ver lo que escribió Fern. Edita el borrador directamente, solicita revisiones enviando un mensaje a Fern en el hilo o publícalo cuando estés conforme.

Puedes filtrar la lista de hilos de Fern seleccionando Has drafts para ver solo los hilos con actualizaciones en borrador listas para revisión.

Tú controlas la publicación

Fern redacta actualizaciones, pero nunca las publica automáticamente. Cada borrador requiere tu revisión y aprobación antes de aparecer en tu centro de ayuda. Esto te da control total sobre lo que se publica, al tiempo que elimina el trabajo manual de supervisar pull requests.

Artículos relacionados

¿Te fue útil?