git clone git@gitlab.com/miusuario/basico_adJ.git

cd sip
git remote add upstream https://gitlab.com/pasosdeJesus/basico_adJ.git

Procura mantener la rama main de tu bifurcación “sincronizada” con la rama main del repositorio upstream (por lo mismo no debes hacer cambios a la rama main de tu bifuración). Lo puedes hacer ejecutando con regularidad: git checkout main git pull --rebase upstream main git push -f origin main

Cuando desees hacer una contribución, comienza por sincronizar tu rama main y desde esta crear una nueva rama donde propondrás el cambio y pon un título que le ayude a limitar el alcance del cambio (si deseas hacer cambios diferentes es mejor que hagas ramas diferentes a partir de la rama main sincronizada), por ejemplo si fuera una rama mejora-documentacion: git checkout main git pull --rebase upstream main git push -f origin main git checkout -b mejora-documentacion En la nueva rama agrega, edita y/o elimina archivos. Puedes examinar modificaciones a archivos con: git status -s agrega archivos que hayas introducido con: git add _archivo_ Cuando completes los cambios realiza un commit (como contribución) con comentario que describa tu contribución, por ejemplo: git commit -m "Mejorando sección sobre sistema de archivos" -a Puedes continuar trabajando y hacer otras contribuciones en la misma rama, pero nos parece más ordenado cuando tu solicitud de cambio (pull request) tiene una sola contribución (commit) y no muchas que sobreescriben otras. Si tienes varias contribuciones para un mismo pull-request más bien fusiónalas (del inglés squash) en una sola. Por ejemplo puedes fusionar los 2 últimos commits con: git rebase -i HEAD~2 Esto abrirá un archivo con los mensajes de las 2 últimas contribuciones y frente a cada uno la palabra pick que podrías cambiar por squash en la segunda contribución para fusionarla con la primera. Después de guardar y salir volverás a un editor para modificar el mensaje que tendrá la contribución fusionada

Tras esto si ves la historia de contribuciones notarás la fusión: git log Una vez tengas bien tu contribución en orden, empuja (push) el cambio a la rama que creaste en tu bifurcación: git push -f origin mejora-documentacion Y desde la interfaz de github/gitlab examinando tu repositorio bifurcado o el original verás un botón para crear la solicitud de cambio (pull-request). Úsalo, revisa lo que enviarás, pon un comentario que justifique el cambio y envíalo.

Cuando hagas un pull request se iniciarán sobre el mismo las tareas de integración continua que estuvieran configuradas y que en general tu cambio debe pasar. Después los desarrolladores revisarán tu cambio y si se requiere escribirán sugerencias de cambio, que debes hacer o justificar por que no conviene antes de que tu contribución sea aceptada. Es decir habrá un diálogo en la parte de comentarios de tu solicitud de cambio que debe continuar.

Con la retroalimentación de las tareas de integración continúa y de desarrolladores debes realizar los cambios en la misma rama donde hiciste la propuesta inicial, pero antes debes sincronizarla con la rama main del repositorio original por si otros desarrolladores han hecho cambios recientes. Para eso primero sincroniza tu rama main:

git checkout main
git pull --rebase upstream main
git push -f origin main

Y de inmediato adopta en tu rama donde hiciste la propuesta, los cambios que pudiera haber en la rama main ya sincronizada:

git checkout mejora-documentacion
git pull --rebase origin main

Esta última operación podría revelar colisiones entre cambios ya aceptados en el repositorio principal y los que tú habías propuesto (por eso es bueno tratar de hacer rápido el diálogo con desarrolladores y las propuestas de cambio). En caso de colisiones debes arreglarlas (en algunos casos editando archivos que tienen marcados los cambios con <<<< y >>>>, en otros añadiendo o eliminando archivos). Después aplica las sugerencias y/o fusiona contribuciones y/o arregla tu código para que pase tareas de integración continua.

vi README.md
....
git commit -m "Aplicando sugerencias de revisor" -a
git rebase -i HEAD~2
git push -f origin mejora-documentacion

Después de empujar tus cambios (push) en la misma rama, github/gitlab notará el cambio y actualizará la solicitud de cambio ya hecha, volviendo a lanzar las tareas de integración continua y los desarrolladores volverán a auditar tu contribución y continuarán el diálogo en la sección de comentarios.

Este proceso debe iterarse hasta que tu cambio sea aceptado (o rechazado), por lo que debes visitar con frecuencia tu solicitud de cambio y ver nuevos comentarios que puedan haber (los comentarios más recientes quedan al final de la pestaña de comentarios).