Una pull request propone fusionar cambios de código de una rama en otra. Como función colaborativa, las pull requests te ofrecen un espacio para comentar y revisar el trabajo antes de que pase a formar parte de un proyecto.
¿Por qué usar solicitudes de incorporación de cambios?
Las pull requests convierten una serie de cambios en el código en una conversación. En lugar de fusionar el trabajo directamente, lo propones para que los colaboradores puedan opinar. Esto le ayuda a usted y a su equipo a mantener código seguro y de alta calidad, de varias maneras:
- Detecta errores y problemas a tiempo, antes de que alcancen la rama principal.
- Analice y mejore los cambios juntos, con comentarios vinculados a líneas específicas.
- Mantenga un historial claro y revisable de lo que cambió y por qué.
Lo que puede hacer con las solicitudes de extracción
Las solicitudes de incorporación de cambios facilitan la revisión y validación de los cambios. Con una solicitud de incorporación de cambios, puede hacer lo siguiente:
- Proponer cambios desde una rama o una bifurcación.
- Analice y revise los cambios propuestos, línea a línea.
- Ejecute comprobaciones automatizadas, como pruebas, compilaciones y análisis de código, con los cambios.
- Responde a los comentarios y actualiza la pull request conforme evolucione.
- Combine los cambios una vez que se cumplen las revisiones y las comprobaciones necesarias.
Partes clave de una pull request
Una solicitud de incorporación de cambios recopila todo lo que usted y los revisores necesitan en un solo lugar:
- La conversación muestra la descripción, los comentarios, las revisiones y una escala de tiempo de actividad.
- Confirmaciones muestra cómo cambió la rama a lo largo del tiempo.
- Las comprobaciones muestran los resultados de pruebas automatizadas, compilaciones y otras validaciones.
- Los archivos modificados muestran las diferencias sobre las que comentan los revisores.
- El cuadro de combinación resume si puede combinar los cambios o no. Muestra lo que puede que aún falte, como revisiones o comprobaciones obligatorias, antes de que se pueda fusionar una pull request.
Cómo encajan las pull requests en tu flujo de trabajo
Independientemente de si va a proponer cambios o revisar los de otra persona, una solicitud de incorporación de cambios sigue algunas fases:
- Cree una rama o una bifurcación del repositorio para crear un entorno aislado en el que trabajar.
- Confirma tus cambios según vayas avanzando, creando así un historial de tu trabajo.
- Abra una solicitud de incorporación de cambios para proponer la combinación de los cambios en la rama base.
- Revise y analice los cambios con colaboradores y realice actualizaciones según sea necesario.
- Fusiona la pull request cuando esté lista.