Borradores automáticos de PR
Activa Borradores automáticos de PR en Settings > Automations para que Fern redacte una actualización de la documentación cuando un pull request fusionado cambie el comportamiento visible para los clientes. Tú sigues revisando y publicando cada borrador; Fern nunca publica automáticamente.
Antes de empezar
Conecta la integración de GitHub para que Fern pueda supervisar los pull requests en tus repositorios.
Activa los borradores automáticos de PR
Abre Settings desde la barra lateral del panel.
Selecciona Automations. La página incluye Borradores automáticos de PR y Auditorías programadas.
Activa Borradores automáticos de PR. La configuración se guarda de inmediato.
Cuando el interruptor está activado, aparecen debajo Sensitivity y Guidance for PR drafts.
Elige la sensibilidad
Usa Sensitivity para controlar con qué facilidad Fern crea un borrador a partir de un pull request fusionado. Elige una opción:
Strict: only clear-cut changes: Fern solo redacta cuando el caso para una actualización de la documentación es más claro.
Balanced: la opción predeterminada. Fern redacta los cambios claros visibles para los clientes y omite los menos sólidos.
Eager: more drafts: Fern crea borradores para un conjunto más amplio de cambios visibles para los clientes.
Cambiar el selector se guarda de inmediato.
La sensibilidad no garantiza un borrador para cada cambio de producto visible. Fern sigue decidiendo si la fusión necesita documentación y luego aplica tu configuración de sensibilidad antes de crear una tarea de redacción.
Añade orientación para borradores de PR
Usa Guidance for PR drafts para instrucciones permanentes, de toda la organización, que Fern aplica cuando examina pull requests fusionados y redacta borradores a partir de ellos.
El campo acepta hasta 4.000 caracteres. Deja el campo para guardar. Si la orientación está vacía, la configuración se borra.
Este campo es independiente de las Drafting instructions y de Research instructions de toda la organización en Settings > Fern. Esas guían la redacción y la investigación generales de Fern. Guidance for PR drafts se aplica solo al filtrado de PR y a los borradores generados a partir de PR.
Qué activa un borrador
Fern redacta a partir de un pull request después de que se fusiona en la rama de producción configurada del repositorio. Si no se ha configurado ninguna rama de producción, Fern usa la rama predeterminada del repositorio. Se omiten los pull requests que se fusionan en otras ramas. También se omiten los pull requests de revertir.
Configura la rama de producción de cada repositorio en la página de la integración de GitHub.
Fern redacta cuando la fusión cambia comportamientos visibles para los clientes que estos necesitan conocer, como flujos de la interfaz, endpoints de API, comportamiento de funciones, mensajes de error u opciones de configuración, y el cambio cumple con tu configuración de sensibilidad.
Fern no crea un borrador cuando:
El cambio es interno o no afecta a los usuarios finales
La documentación relevante ya está actualizada
El cambio es visible para los clientes, pero no cumple con tu configuración de sensibilidad actual
En esos casos, Fern sigue registrando un cambio de código marcado como No documentation changes needed. Estos hilos no aparecen en la lista predeterminada All. Filtra la página de Fern por Automations para revisarlos. Abre un hilo para ver el encabezado y cualquier explicación que Fern haya guardado.
Revisa 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 cambió y el estado del borrador.
Abre el hilo. Cuando el borrador esté listo, elige Review & edit changes. Edita el borrador, solicita revisiones en el hilo o publícalo cuando estés conforme.
Filtra la lista de hilos de Fern con Has drafts para ver solo los hilos que tienen actualizaciones de borrador listas para revisión.
Tú controlas la publicación
Fern redacta actualizaciones, pero nunca las publica automáticamente. Cada borrador necesita tu revisión antes de aparecer en tu centro de ayuda.