Git y GitHub Pro

Setup de Git Configura Git bien una vez: tu nombre, email y defaults. Evita problemas en equipos desde el dia 1. Conceptos clave git config --global SSH keys vs HTTPS git status como radar Ejemplo git --version git config --global user.name "Tu Nombre" git config --global user.email "[email protected]" git config --global init.defaultBranch main Ejercicio Configura user.name y user.email. Crea un repo local y ejecuta git status. Checklist de mastery Mi identidad esta configurada. Puedo crear un repo

Commits buenos Un buen commit hace que el futuro sea facil: explica el por que y deja una historia navegable. Conceptos clave git add -p para commitear por partes Mensajes: feat/fix/docs Evitar commits gigantes Ejemplo git add -p git commit -m "feat: agrega pagina de cursos" # o # fix: corrige ruta /course vs /courses Ejercicio Haz 2 commits separados: uno para UI, otro para logica. Revisa el historial con git log --oneline. Checklist de mastery Se partir cambios en commits. Mis mensajes son uti

Historia y diff Aprende a leer cambios y encontrar el commit que rompio algo. Esto te ahorra horas. Conceptos clave git diff y git show git log --graph git blame para contexto (no para culpar) Ejemplo git diff git show HEAD git log --oneline --graph --decorate --all git blame path/al/archivo.ts Ejercicio Encuentra el ultimo commit que toco un archivo con git log path. Usa git show para ver el diff de un commit. Checklist de mastery Puedo inspeccionar cambios sin miedo. Se usar blame para entende

Branches Branch por cambio. Siempre. Esto reduce conflictos y permite reviews claros. Conceptos clave git checkout -b git pull --rebase (opcional) branches cortas y orientadas a un objetivo Ejemplo git checkout -b feat/landing-blog # trabajar... git push -u origin feat/landing-blog Ejercicio Crea una branch feat/mi-cambio. Subela a origin con -u. Checklist de mastery Se crear y subir branches. Se mantener branches pequenas.

Pull Request Un PR bueno tiene: contexto, como probar, riesgos y capturas si es UI. Eso acelera el merge. Conceptos clave Descripcion clara (que y por que) Pasos de prueba Pequenos PRs ganan Ejemplo Template rapido: Contexto -> Cambios -> Como probar -> Riesgos -> Capturas. Ejercicio Crea un PR con una descripcion de 5 lineas. Incluye pasos para probar localmente. Checklist de mastery Mis PRs son faciles de revisar. Siempre incluyo como probar.

Rebase vs Merge No es guerra. Aprende la diferencia y elige segun tu equipo. Objetivo: historia legible sin sorpresas. Conceptos clave merge conserva historia completa rebase re-escribe historia (con cuidado) Nunca rebase de branches compartidas Ejemplo git fetch origin git rebase origin/main # resolver conflictos si aparecen git push --force-with-lease Ejercicio Trae cambios de main a tu branch (merge o rebase). Explica por que elegirias uno u otro. Checklist de mastery Se cuando NO usar rebase

Conflictos Los conflictos no son un error moral. Son dos cambios sobre la misma zona. Aprende un proceso simple para resolverlos. Conceptos clave Buscar markers <<<<<<< ======= >>>>>>> Elegir una version o combinar Correr tests despues Ejemplo git fetch origin git rebase origin/main # si hay conflicto # 1) editar archivo # 2) git add -A # 3) git rebase --continue Ejercicio Crea un conflicto intencional en dos branches y resuelvelo. Despues corre pnpm tes

Herramientas de rescate Estas tres palabras parecen iguales pero no lo son. Aprende a usarlas sin perder trabajo. Conceptos clave stash guarda cambios temporales reset mueve HEAD (peligroso si no sabes) revert crea un commit que deshace (seguro en main) Ejemplo git stash -u # ... cambiar de branch git stash pop # revert seguro git revert <commit> Ejercicio Stashea cambios, cambia de branch y recuperalos. Revierte un commit en una branch de prueba. Checklist de mastery Uso revert para desha

Tags y releases Versionar te ayuda a debugear y a desplegar con seguridad. Un tag es un punto fijo en la historia. Conceptos clave SemVer (v1.2.3) basico Tags anotados Release notes cortas Ejemplo git tag -a v0.1.0 -m "primer release" git push origin v0.1.0 Ejercicio Crea un tag v0.1.0 en tu repo. Escribe 3 bullets de release notes. Checklist de mastery Se crear y empujar tags. Entiendo por que ayudan en deploy/debug.

Repo con README Tu README es tu mejor vendedor. Explica que hace el proyecto, como correrlo y como probarlo. Conceptos clave Instalacion, scripts y estructura Como probar (pasos) Capturas si es UI Ejemplo README minimo: Que es -> Setup -> Scripts -> Como probar -> Deploy. Ejercicio Crea un README de 20 lineas con secciones. Agrega un comando de prueba real. Checklist de mastery Mi repo se entiende sin preguntarme. Incluyo pasos concretos para probar.

Convenciones Convenciones reducen friccion. No son burocracia: son UX para equipos. Conceptos clave feat/fix/docs/chore Scopes opcionales Titulos cortos, descripcion util Ejemplo feat(blog): agrega posts y rss fix(seo): incluye /blog en sitemap chore(seed): agrega cursos publicos Ejercicio Re-escribe 3 commits tuyos con mensajes mejores. Crea un PR con titulo y descripcion consistentes. Checklist de mastery Mis mensajes son consistentes. Mis PRs tienen contexto y pasos.

CI basico CI es un guardia automatico. Corre tests, lint y type-check en cada PR para que el main sea estable. Conceptos clave Workflow on: pull_request Cache de deps Pasos: install -> test -> build Ejemplo name: CI on: [pull_request] jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - run: pnpm install - run: pnpm test Ejercicio Define el pipeline minimo de tu proyecto. Decide que bloquea el merge (tests/build). Checklist de mastery Se por que CI reduce bugs. Tengo un