Creación y revisión de pull requests

Las pull requests (PR) son fundamentales para el desarrollo colaborativo en plataformas como GitHub. Permiten proponer cambios en un proyecto y hacer que se revisen antes de integrarlos.

Considere una PR como una solicitud formal para fusionar su nuevo código en una rama principal, normalmente main o develop.

Las PR ofrecen varias ventajas importantes para equipos y desarrolladores individuales:

• Revisión de código: otras personas pueden revisar su código para detectar errores, comprobar las prácticas recomendadas y proponer mejoras.
• Debate: proporcionan un espacio específico para debatir los cambios.
• Control de calidad: garantiza que solo el código aprobado y probado se incorpore al proyecto principal.
• Seguimiento de cambios: ofrece un historial claro de quién cambió qué y por qué.

El flujo de trabajo habitual de una pull request incluye estos pasos:

1. Cree una rama nueva para su funcionalidad o corrección.
2. Realice cambios y haga commit de ellos en su rama nueva.
3. Envíe su rama a GitHub.
4. Abra una pull request en GitHub.
5. Las personas revisoras proporcionan comentarios y aprueban los cambios.
6. Fusione los cambios en la rama principal.

Antes de realizar cambios, lo recomendable es crear una rama nueva. Así mantiene su trabajo aislado del proyecto principal hasta que esté listo.

Use git checkout -b para crear una rama nueva y cambiarse a ella:

Ahora, realice los cambios de código necesarios para su funcionalidad o corrección de errores. Cuando termine, prepare y confirme los cambios en su nueva rama, como con cualquier otra confirmación de Git.

Después de confirmar los cambios localmente, envíe su nueva rama al repositorio remoto en GitHub. Esto hará que su rama y sus confirmaciones sean visibles en línea.

La opción -u establece la rama upstream, por lo que los futuros comandos git push serán más sencillos.

Una vez enviada su rama, GitHub normalmente le ofrecerá crear un Pull Request directamente desde la página de su repositorio o desde la pestaña «Pull requests».

• Seleccione su rama de funcionalidad como head (origen).
• Seleccione la rama main (o rama de destino) como base.
• Añada un título y una descripción claros que expliquen sus cambios.

Después de abrirlo, su PR entra en la fase de revisión. Los miembros del equipo (revisores) examinarán su código, harán preguntas o sugerirán mejoras.

• Pestaña Conversation: Debates y comentarios.
• Pestaña Files changed: Consulte las diferencias exactas del código (diff).
• Pestaña Commits: Consulte las confirmaciones individuales del PR.

Los revisores pueden dejar comentarios directamente en las líneas de código o proporcionar comentarios generales. Después pueden:

• Aprobar: El código está listo.
• Solicitar cambios: Es necesario realizar más trabajo antes de fusionarlo.
• Comentar: Proporcionar comentarios generales sin bloquear la fusión.

Es posible que deba realizar más confirmaciones en su rama de funcionalidad a partir de los comentarios recibidos.

Una vez aprobado, su PR se puede fusionar en la rama base. GitHub ofrece varias opciones de fusión:

• Merge commit: Conserva todas las confirmaciones de la rama de funcionalidad.
• Squash and merge: Combina todas las confirmaciones en una nueva confirmación.
• Rebase and merge: Reproduce las confirmaciones de la rama de funcionalidad sobre la rama base.

El método elegido afecta al historial de confirmaciones del proyecto.

Acaba de aprender los pasos fundamentales para crear y gestionar Pull Requests. ¡Compruebe lo que ha aprendido!

Los Pull Requests son fundamentales para la colaboración moderna en equipo. Ha aprendido a:

• Crear una nueva rama para su trabajo.
• Enviar su rama a GitHub.
• Iniciar un Pull Request.
• Comprender el proceso de revisión y aprobación.
• Fusionar sus cambios en el proyecto principal.

¡Dominar los PR es clave para contribuir eficazmente a cualquier proyecto basado en Git!