Administración y estandarización de solicitudes de incorporación de cambios

Si mantiene un repositorio, puede usar las características de GitHub para que las pull requests sean más uniformes y fáciles de revisar. La estandarización ayuda a los colaboradores a saber qué información proporcionar, ayuda a los revisores a centrarse en los cambios correctos y ayuda a proteger las ramas importantes frente a combinaciones accidentales o de riesgo.

Uso de plantillas de solicitud de incorporación de cambios

Las plantillas de solicitud de incorporación de cambios ayudan a los colaboradores a proporcionar el contexto que el proyecto necesita para su revisión. Una plantilla puede pedir a los autores que expliquen el propósito del cambio, vincular problemas relacionados, incluir notas de prueba o completar una lista de comprobación antes de solicitar la revisión.

Las plantillas son útiles cuando muchos colaboradores abren solicitudes de incorporación de cambios o cuando el proyecto tiene expectativas de revisión que deben estar visibles cada vez. Consulta Crear una plantilla de pull request para tu repositorio, Acerca de las listas de tareas, y Vincular una solicitud de cambios a una propuesta.

Definición de propietarios de código

Los propietarios de código identifican a las personas o equipos responsables de archivos o directorios específicos. Cuando una solicitud de incorporación de cambios cambia el código de propiedad, GitHub puede solicitar automáticamente una revisión de los propietarios de los derechos.

Los responsables del código ayudan a dirigir las revisiones hacia las personas con el contexto adecuado. Son especialmente útiles para áreas confidenciales, como archivos de seguridad, configuración de implementación o bibliotecas compartidas. Consulte Acerca de los propietarios de código.

Usando ramas protegidas

Las ramas protegidas ayudan a mantener ramas importantes, como main, estables. Pueden requerir condiciones como pasar comprobaciones de estado, confirmaciones firmadas o aprobar revisiones antes de que una solicitud de incorporación de cambios pueda combinarse.

Use ramas protegidas cuando una rama represente código de producción, una línea de versión u otra fuente importante de verdad. Consulte Acerca de las ramas protegidas.

Uso de conjuntos de reglas

Los conjuntos de reglas permiten aplicar directivas de repositorio entre ramas y etiquetas. Pueden requerir comprobaciones de estado, flujos de trabajo, revisiones de solicitudes de incorporación de cambios u otras condiciones antes de que se acepten los cambios.

Los conjuntos de reglas son útiles cuando quieres reglas uniformes en varias ramas o cuando quieres combinar los requisitos de revisión con comprobaciones de seguridad automatizadas, como la revisión de dependencias o la protección de combinación code scanning. Consulta Acerca de los conjuntos de reglas, Aplicación de la revisión de dependencias en una organización, y Establecimiento de la protección contra la fusión de análisis de códigos.

Uso de conjuntos de reglas de inserción

Con los conjuntos de reglas de inserción, puedes bloquear las inserciones en un repositorio privado o interno y la red de bifurcación completa del repositorio en función de extensiones de archivo, longitudes de ruta de acceso de archivo, rutas de acceso de archivo y carpetas y tamaños de archivo.

Las reglas de inserción no requieren ningún destino de rama porque se aplican a cada inserción en el repositorio.

Los conjuntos de reglas de inserción te permiten:

• Restringir rutas de acceso de archivo: impide que se inserte la inserción de confirmaciones que incluyan cambios en las rutas de acceso de archivo especificadas.

  Para ello, puedes usar la sintaxis fnmatch. Por ejemplo, una restricción dirigida test/demo/**/* evita las inserciones en archivos o carpetas del directorio test/demo/. Un destino de restricción test/docs/pushrules.md impide que las inserciones se inserten específicamente en el archivo pushrules.md del directorio test/docs/. Para más información, consulta Creación de conjuntos de reglas de un repositorio.

• Restringir la longitud de la ruta de acceso del archivo: impide que se inserten confirmaciones que incluyan rutas de acceso de archivo que superen un límite de caracteres especificado.

• Restringir extensiones de archivo: impide que las confirmaciones que incluyan archivos con extensiones de archivo especificadas se inserten.

• Restringir el tamaño del archivo: evita que se inserten confirmaciones que superen un límite de tamaño de archivo especificado.

Acerca de los conjuntos de reglas de inserción para repositorios bifurcados

Las reglas de inserción se aplican a toda la red de bifurcación de un repositorio, lo que garantiza que todos los puntos de entrada del repositorio están protegidos. Por ejemplo, si bifurcas un repositorio con conjuntos de reglas de inserción habilitados, los mismos conjuntos de reglas de inserción también se aplicarán al repositorio bifurcada.

En el caso de un repositorio bifurcada, las únicas personas que tienen permisos de omisión para una regla de inserción son las personas que tienen permisos de omisión en el repositorio raíz.

Los conjuntos de reglas de inserción ayudan a bloquear el contenido de riesgo antes de entrar en el repositorio. Consulte Acerca de los conjuntos de reglas.

Mediante herramientas automatizadas para revisar el estilo de código

Las herramientas automatizadas, como linters y formateadores, ayudan a mantener el estilo de código coherente entre las solicitudes de incorporación de cambios. Pueden detectar problemas pequeños automáticamente para que los revisores puedan centrarse en el diseño, la corrección y la capacidad de mantenimiento.

Puede ejecutar estas herramientas como parte de un flujo de trabajo de integración continua con GitHub Actions. Consulte Integración continua.