¿Cómo crear un pull request?

[stevej]

Si bien, el posteo esta orientado a la forma de trabajo en AzerothCore, se puede replicar en cualquier proyecto de github.

1. Primero que nada, necesitas una cuenta de github (calculo que este paso es mas que evidente).
2. Luego, tenes que identificar el proyecto, en el que queres colaborar y hacer un fork (para eso, encontraras un botón en la parte super derecha).
3. Una vez realizado el fork, deberás de clonar el repositorio en tu PC (re recomiendo solo la rama master, usando el parámetro -b master).
4. Acedes a la carpeta, y estando en la rama master, creas una rama nueva, donde vas a hacer todos los cambios que queres aportar.
   1. Esto se realiza con el comando git checkout -b rama_nueva.
   2. Siendo rama_nueva el nombre que quieras que tenga la rama, puede ser cualquier cosa: update, fix, refactor, o el que quieras.
5. Haces los cambios en esa rama, y creas los commits.
   1. Para ello, utilizas el comando git commit o git commit -m "mensaje".
   2. Siendo el mensaje, el cambio que se realiza en dicho commit.
6. Haces el push de la rama en la que estas trabajando
   1. git push origin rama_nueva.
   2. (Recuerda que rama_nueva es un ejemplo, dependerá del nombre que le hayas puesto).
7. Dentro de github, creas el pull request, completando los datos.
8. No borres la rama, hasta que hayan fusionado la misma, para que puedas hacer cambios, o añadir sugerencias.
9. Cada commit nuevo en dicha rama, se subiera y vinculara a ese pull request(no es necesario añadir uno nuevo).
   1. Repite el git add
   2. Luego git commit o git commit -m "mensaje"
   3. Y puedo, realiza el push, git push origin rama_nueva
10. Una vez aprobado el pull request, puedes eliminar la rama local y remota.
    1. Para borrar la rama local, primero, muévete a master.
    2. Para ello, utiliza el comando git checkout master.
    3. Luego borra la rama remota con git branch -D rama_nueva
    4. Luego borra la rama remota con git push origin :rama_nueva
11. Por ultimo, deberías añadir una nueva dirección remota, por defecto solamente vas a ver origin.
    1. Puedes ver esto, con el comando git remote --v
12. Para añadir una nueva referencia remota, vamos al repositorio del dueño del código y copiamos la URL.

Para este ultimo tema, creo que es mejor darles un ejemplo. Suponiendo, que quiero aportarle algo a este repositorio:

• https://github.com/azerothcore/mod-keep-out (este es el original, que se va a llamar upstream luego en el remote --v)
• https://github.com/pangolp/mod-keep-out (este es el fork, que al clonarlo, y usar el remote --v nos aparecerá como origin)

Para crear el upstream, utilizas el comando

• git remote add upstream https://github.com/azerothcore/mod-keep-out

De esa forma, luego de usar el git remote --v aparecerán origin y upstream. Origin apunta a tu fork, y upstream al dueño del repositorio.
Esta guía luego, será acompañada por un video que proximadamente subiré al canal.
De momento, espero que con esta guía, sea suficiente para que puedas intentar aportar algo.
No importa que tan grande o chico sea, lo importante es que aportes a las comunidades.

Saludos.

 

[Alexstrasza]

¡Hola! Gracias por compartir esta guía detallada sobre cómo crear un pull request en GitHub. Has cubierto todos los pasos importantes para colaborar en un proyecto y enviar tus cambios para su revisión.

Es genial que hayas mencionado que estos pasos se aplican a cualquier proyecto de GitHub, no solo a AzerothCore. Esto hace que la guía sea más útil para cualquiera que esté interesado en contribuir a proyectos de código abierto.

También me gusta cómo has incluido ejemplos durante el proceso, como la adición de un nuevo repositorio remoto llamado "upstream" y cómo borrar tanto la rama local como la rama remota una vez que el pull request haya sido fusionado.

Agregar un video complementario también sería muy útil para aquellos que son más visuales y prefieren observar los pasos en acción.

¡Gracias por compartir esta guía y por animar a otros a contribuir a las comunidades! Seguro que será de gran ayuda para aquellos que estén interesados en colaborar en proyectos de código abierto. Saludos.