Enviar cambios a KumbiaPHP (Pull request)

pull-request-kumbiaphp.md

Enviar cambios a KumbiaPHP (PR - Pull Request).

Primero que todo debes tener instalado git en tu equipo, una cuenta en https://github.com/ y debes iniciar sesión.

Copia (fork) del repositorio oficial

1. Ir al repositorio del framework: https://github.com/KumbiaPHP/KumbiaPHP

2. Hacer clic en el botón "fork", esto creará en tu cuenta una copia completa del repositorio.

Clonar tu repositorio

Esto nos permitirá trabajar de manera local con el fork que acabamos de realizar, así nos aseguramos por ejemplo de no cambiar nada directamente y estropearlo todo.

1. Copiar la URL que aparece al darle clic al botón "Clone or download".

2. Ir a una terminal y ejecutar el comando: git clone https://github.com/tuusuario/KumbiaPHP.git

3. Entrar a la carpeta KumbiaPHP cd KumbiaPHP

4. Especificar el remote upstream con el cual se sincronizarán los cambios con el comando: git remote add upstream https://github.com/KumbiaPHP/KumbiaPHP.git

5. Verificar que se haya asignado el remote upstream a nuestra copia con el comando: git remote -v

origin	https://github.com/tuusuario/KumbiaPHP.git (fetch) 
origin	https://github.com/tuusuario/KumbiaPHP.git (push) 
upstream	https://github.com/KumbiaPHP/KumbiaPHP.git (fetch) 
upstream	https://github.com/KumbiaPHP/KumbiaPHP.git (push) 

6. Trabaja en la rama de desarrollo, por ejemplo dev: git checkout dev

Especificar tus datos de usuario

Ejecuta los siguientes comandos en la terminal:

1. Para modificar el correo electrónico: git config user.email "tucorreo@gmail.com"

2. Para modificar el nombre de usuario: git config user.name "Tu Nombre"

Subir cambios a tu repositorio

1. Recuerda trabajar y hacer los cambios en la rama de desarrollo: git checkout dev

2. Agrega los archivos para el commit: git add core/extensions/helpers/html.php

3. Realiza los commits necesarios, se muy claro con los mensajes: git commit -m "Mejora en la documentación, añadiendo ejemplos a la clase Html"

4. Sube los cambios a tu repositorio en Github: git push origin dev

Enviar cambios al repositorio oficial

1. Ve a tu repositorio en Github.com y haz clic en el botón "New pull request".

2. Escibe un titulo para el request y un mensaje claro de la solicitud.

3. Clic en el botón "Create pull request".

4. Ya solo queda esperar que alguien del core lo autorice e integre los cambios.

Sincronizando la copia (fork) con el reposiotorio oficial

Si la copia de nuestro repositorio no es reciente, es probable que el equipo de desarrollo haya añadido cambios al código del repositorio oficial, por esto es importante mantener sincronizada nuestra copia antes de que empecemos a trabajar en algo nuevo o antes de subir los cambios.

1. Obtener las ramas y sus respectivos commits del repositorio 'upstream': git fetch upstream

2. Asegurarse de estar en la rama de desarollo: git checkout dev

3. Mezclar los cambios de upstream/dev dentro de tu rama local de desarrollo. Esto hará que tu rama de desarrollo se sincronice con el repositorio oficial, sin perder los cambios locales: git merge upstream/dev