Usage of GitHub for organizations (Basics)

basic-github-organizations.md

TUTORIAL DE GIT PARA USO EN ORGANIZACIONES

1- PASOS INICIALES CON UN NUEVO REPOSITORIO

1. Crear y entrar en un nuevo directorio

mkdir <new_repo_path> &&
cd <new_repo_path>

2. Sincronizarse completamente con el repositorio:

git init                                        # Inicia control de versiones y genera el directorio .git
git branch -M main                              # Crea la pranch principal y setéala como tal (Best practices: main)
git remote add origin <enlace_a_repositorio>    # Enlaza el directorio con el repositorio
git fetch                                       # Sincroniza con las branches del repositorio
git pull origin main                            # Trae la última versión del respositorio a tu sistema local

2.1. La alternativa en un solo comando:

git clone <enlace-a-repositorio> <new_repo_path>
cd <new_repo_path>

2- COMO MOVERSE ENTRE BRANCHES

1. Ver todas las branches (Locales y remotas)

git branch -a

2. Cambiar a la branch que te interesa

git checkout <nombre_branch>

3. Ver branches locales para asegurar el cambio de branch

git branch

3- COMO HACER UN COMMIT Y SUBIRLO AL REPOSITORIO (¡SIEMPRE EN TU BRANCH!)

1. Hacer pull de lo último que haya en tu branch

git pull origin <tu_branch>

2. Observar los cambios que implementa tu código

git status
git diff        # Usa la tecla "q" para salir.

3. Añadir las modificaciones al Staging area

git add .

4. Commitear los cambios

git commit -m "<Your_detailed_message>"

5. Subirlo al repositorio

git push origin <tu_branch>

4- COMO HACER UN MERGE DE TU BRANCH (BEST PRACTICES)

1. Ve a tu repositorio en Github

2. Ve a la pestaña "Pull requests" y haz click en "New pull request"

3. Elige la branch de destino y la branch de origen (tu_branch)

4. Verifica las modificaciones esperadas en la parte inferior de la página. Si son correctas, haz click en "Create pull request"

5. Pide a algún colaborador que revise tu "Pull Request" si es necesario. Una vez revisada y aprobada, haz click en "Merge pull request".

5- COMANDOS PARA VERIFICAR ESTADOS

git status      # Muestra estado del Staging Area
git log         # Muestra los commits realizados junto con su hash (identificador)

6- TUTORIALES EN VÍDEO RECOMENDADOS

Tutorial GIT para principiantes parte 1 (20 min)

Tutorial GIT para principiantes parte 2 (14 min)

7- Buenas Prácticas:

• No dejes en repositorio una versión que no funciona

• Realiza commits frecuentes con cambios pequeños

8- RESOLUCIÓN DE ERRORES

Revertir el último cambio (Crear un nuevo commit que deshace el último commit)

git revert HEAD~1

Cuidado: Se abrirá nu nuevo editor de texto. Necesitarás guardar y salir. (editor nano: crtl+o crtl+w | editor vim: :x)

Descommitear el último commit

git reset HEAD~1

Mover un commit a otra branch.

git checkout <branch_origen>
git log          # Debes copiar el hash del commit a mover
git checkout <branch_destino>
git cherry-pick <commit-hash>
git checkout <branch_origen>
git reset HEAD~1 # Elimina el commit de la branch_origen