Borradores automáticos de PR
Activa Borradores automáticos de PR en Configuración > Automatizaciones para que Fern redacte una actualización de la documentación cuando un pull request fusionado cambie el comportamiento orientado al cliente. 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.
Habilita los borradores automáticos de PR
Abre Configuración desde la barra lateral del panel.
Selecciona Automatizaciones. 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 Sensibilidad y Orientación para borradores de PR.
Elige la sensibilidad
Usa Sensibilidad para controlar con qué facilidad Fern crea un borrador a partir de un pull request fusionado. Elige una opción:
Estricto: solo cambios claramente definidos: Fern redacta borradores solo cuando el caso para una actualización de la documentación es más sólido.
Equilibrado: la opción predeterminada. Fern redacta los cambios claros orientados al cliente y omite los menos relevantes.
Entusiasta: más borradores: Fern crea borradores para un conjunto más amplio de cambios orientados al cliente.
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 borrador.
Añade orientación para borradores de PR
Usa Orientación para borradores de PR para instrucciones permanentes, de toda la organización, que Fern aplica cuando revisa 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, se borra la configuración.
Este campo es independiente de las Instrucciones de redacción y de las Instrucciones de investigación de toda la organización en Configuración > Fern. Estas guían la escritura y la investigación generales de Fern. Orientación para borradores de PR se aplica solo a la revisión de PR y a los borradores generados a partir de PR.
Qué activa un borrador
Fern considera un pull request después de que se fusiona en la rama predeterminada del repositorio en un repositorio de GitHub conectado. Los pull requests de reversión se omiten antes de la revisión.
Fern redacta borradores cuando la fusión cambia el comportamiento orientado al cliente que los clientes necesitan conocer, como flujos de interfaz, endpoints de API, comportamiento de funcionalidades, mensajes de error u opciones de configuración, y el cambio supera 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 está orientado al cliente pero no cumple con tu configuración actual de sensibilidad
En esos casos, Fern sigue registrando un cambio de código marcado como No se necesitan cambios en la documentación. Esos hilos no aparecen en la lista predeterminada Todos. Filtra la página de Fern por Automatizaciones para revisarlos. Abre un hilo para ver el encabezado y cualquier explicación que Fern haya guardado.
Si tienes varios repositorios conectados, Fern puede limitar el análisis al repositorio en el que ocurrió la fusión. Para cambios específicos de una rama, Fern puede explorar esa rama antes de redactar.
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 Revisar y editar cambios. Edita el borrador, solicita revisiones en el hilo o publícalo cuando estés satisfecho.
Filtra la lista de hilos de Fern con Tiene borradores para ver solo los hilos que tienen actualizaciones de borrador listas para revisar.
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.