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 de cara al cliente, Fern lo detecta y redacta automáticamente una 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. Tú sigues revisando y aprobando 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 tu repositorio de GitHub conectado. Si una fusión cambia algo que tus clientes necesitan saber, Fern crea un borrador de artículo o una actualización.

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

Requisitos previos

  • Integración de GitHub conectada: Fern necesita acceso a tu repositorio para supervisar los pull requests. Si aún no has conectado GitHub, primero configura la integración antes de continuar.

Activar borradores automáticos de PR

1

Go to Settings

Abre la configuración (Settings) desde la barra lateral en 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 las auditorías programadas.

3

Enable the toggle

Activa la opción Automatic PR drafts. El ajuste se guardará de inmediato y verás un mensaje de confirmación.

Una vez activado, Fern comienza a supervisar los pull requests fusionados en busca de cambios que afecten al cliente.

Qué activa un borrador

Fern redacta una actualización cuando:

  • Se fusiona un pull request en tu repositorio de GitHub conectado

  • La fusión incluye cambios en el comportamiento de cara al cliente (flujos de interfaz de usuario, puntos de conexión de API, comportamiento de funciones, mensajes de error u opciones de configuración)

Fern analiza las diferencias (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 las 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 y los metadatos del PR

  • Un resumen de lo que ha cambiado

  • El estado del borrador (trabajando, listo para revisar o 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 Fern ha redactado. Edita el borrador directamente, solicita revisiones enviando un mensaje a Fern en el hilo o publica cuando estés satisfecho.

Puedes filtrar la lista de hilos de Fern seleccionando Has drafts para ver solo los hilos con actualizaciones de borradores listos 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 que aparezca en tu centro de ayuda. Esto te brinda un control total sobre lo que se publica mientras elimina el trabajo manual de supervisar los pull requests.

Artículos relacionados

¿Te fue útil?