Actualizar la documentación al fusionar una solicitud de incorporación de cambios
Fern prepara un borrador para el centro de ayuda cuando fusionas una solicitud de incorporación de cambios que afecta a algo que ven tus clientes. Cada borrador espera a que lo revises. Fern nunca publica por su cuenta.
Necesita que la app de GitHub de Ferndesk esté instalada en tus repositorios. Los propietarios y administradores pueden cambiar esta opción.
Elige de qué solicitudes de incorporación de cambios prepara borradores Fern
Los espacios de trabajo nuevos empiezan con Cambios visibles para los usuarios. Para cambiar esta opción, ve a Fern > Personalizar > Automatizaciones y configura Crear borradores a partir de PR fusionadas:
Opción | Fern prepara borradores para |
|---|---|
Funciones principales | Solo los cambios más importantes que afectan a los clientes |
Cambios visibles para los usuarios | Cualquier cambio que tus clientes noten |
Todas las PR | La gama más amplia de cambios, incluidos los pequeños |
Desactivado | Nada |
Con cualquier configuración, Fern no prepara borradores para fusiones que no requieren cambios en la documentación. Para establecer reglas permanentes, añade Instrucciones de filtrado en el mismo menú; por ejemplo: «Omitir las PR con la etiqueta chore o refactor».
Iniciar sesión con GitHub no es suficiente. Si la app de GitHub de Ferndesk no está instalada en tus repositorios, la configuración indicará que todavía no se puede ejecutar. Instala la app desde Conectar GitHub.
Qué fusiones lee Fern
Fusiones en la rama de producción de cada repositorio. De forma predeterminada, es la rama predeterminada, a menos que configures una Rama de producción para el repositorio en la página de integración con GitHub.
Si tu rama predeterminada es staging, pero los clientes reciben lo que está en main, establece main como rama de producción. Entonces Fern prepara un borrador una sola vez, cuando se fusiona en main la solicitud de incorporación de cambios de la versión.
Solo los repositorios que tengan activada la documentación en la misma página.
Sin reversiones. Se omiten las solicitudes de incorporación de cambios cuyo título empieza por «Revert».
Fern prepara borradores a partir de solicitudes de incorporación de cambios fusionadas, no de versiones ni etiquetas de GitHub. Si prefieres documentar cada versión, configura Crear borradores a partir de PR fusionadas como Desactivado y pídele ayuda a Fern cuando publiques una versión, adjuntando las notas de la versión.
Cuando una fusión no requiere cambios en la documentación o es menor de lo que indica la configuración Crear borradores a partir de PR fusionadas, Fern la registra como No se necesitan cambios en la documentación, junto con los motivos. Filtra la lista de Fern por Automatizaciones para ver estas fusiones.
Qué se considera una revisión de PR
Cada solicitud de incorporación de cambios fusionada que Fern revisa consume una revisión de PR, tanto si Fern prepara un borrador como si no. Esto incluye las fusiones que Fern determina que no requieren cambios en la documentación, las que omite por tus Instrucciones de filtrado y las que son menores de lo que indica la configuración Crear borradores a partir de PR fusionadas. Las fusiones que Fern no lee (consulta más arriba) y las tareas que inicias tú no consumen ninguna. Puedes consultar la asignación de tu plan en Límites de uso.
Si se agotan tus revisiones de PR, Fern dejará de revisar fusiones hasta que se restablezca la asignación o compres más. Las fusiones realizadas durante ese período no se revisarán más adelante. Los propietarios y administradores pueden consultar Revisiones de PR y comprar más en Configuración > Espacio de trabajo > Uso.
Revisar un borrador
Cada borrador aparece en Fern como un hilo correspondiente a su solicitud de incorporación de cambios, con un resumen de los cambios. Elige Revisar y editar cambios para editar y publicar, o No es relevante si no debería documentarse. Los hilos marcados como «No es relevante» desaparecen de tu lista y permanecen bajo el filtro Automatizaciones.
Si no se creó un borrador para una fusión, consulta Solucionar problemas de Fern.