Git y GitHub para principiantes: Tu primera contribución open source

La primera vez que un profesor me dijo "sube esto a Git" no tenía ni idea de qué estaba hablando. Pensé que era una carpeta compartida más, tipo Dropbox con otro nombre. Tardé semanas en entender que era otra cosa completamente distinta, y no fue hasta que perdí trabajo de verdad —una tarde entera de código sobrescrita sin querer— cuando entendí para qué sirve de verdad.

Si te suena esa sensación de "todo el mundo lo usa y yo no tengo ni idea por dónde empezar", este tutorial es justo para eso. Vamos a instalar Git, configurarlo, ver los comandos que se usan el día a día y terminar haciendo tu primera contribución a un proyecto real. Asumo que ya sabes programar algo básico — si todavía andas con las variables y los bucles, échale un ojo primero a nuestro tutorial de JavaScript básico y vuelve después. Nada de memorizar 50 comandos que no vas a tocar en la vida.

¿Qué es Git y por qué debería importarme?

Git es como un "historial de cambios" ultra avanzado para tu código. Imagina que cada vez que guardas tu proyecto, Git toma una "foto" completa de todos los archivos. Puedes volver a cualquier "foto" anterior cuando quieras.

El problema que resuelve Git

Antes de usar Git de verdad, mi flujo de trabajo era este (y probablemente el tuyo también, si nunca lo has usado):

mi-proyecto/
├── index.html
├── index-copia.html
├── index-final.html
├── index-final-REAL.html
├── index-funciona.html
└── index-NO-TOCAR.html

Con Git, tienes un solo archivo index.html y Git guarda automáticamente todas las versiones anteriores. Puedes:

• Volver a cualquier versión anterior
• Trabajar en equipo sin pisar el código de otros
• Crear "ramas" para experimentar sin romper nada
• Ver exactamente qué cambió entre versiones

Git vs GitHub: cuál es la diferencia

Analogía simple: Git es tu cámara, GitHub es Instagram. Git toma las fotos (versiones), GitHub las comparte al mundo.

Aquí es donde la mayoría se lía al principio: usan "Git" y "GitHub" como sinónimos. Podrías usar Git toda tu vida sin tocar GitHub — de hecho hay alternativas como GitLab o Bitbucket que hacen lo mismo que GitHub. Git es el motor, GitHub es solo uno de los sitios donde puedes aparcarlo.

Instalación: de cero a listo en unos minutos

Instalar Git

# Ubuntu/Debian
sudo apt update
sudo apt install git

# Fedora
sudo dnf install git

Configuración inicial (obligatorio)

Antes de usar Git por primera vez, debes decirle quién eres. Esto no es un paso opcional que puedas saltarte — si no lo haces, Git se queja en el primer commit y te obliga a hacerlo igualmente, así que mejor quitarlo de en medio ahora:

git config --global user.name "Tu Nombre"
git config --global user.email "tu@email.com"

Verificar que todo funciona

git --version
git config --list

Si ves tu nombre y email en la lista, ya está todo listo.

Los 7 comandos de Git que vas a usar el 90% del tiempo

Olvídate de memorizar decenas de comandos. Con estos 7 cubres casi todo el trabajo diario:

Comandos para empezar proyectos

git init

git clone https://github.com/usuario/proyecto.git

Comandos para guardar cambios

git status

git add .              # Todos los archivos
git add archivo.txt    # Un archivo específico

git commit -m "Descripción clara del cambio"

Comandos para sincronizar con GitHub

6. git push - Subir cambios

Sube tus commits a GitHub

git push origin main

7. git pull - Descargar cambios

Descarga los últimos cambios desde GitHub

git pull origin main

# Ver qué cambió
git status

# Preparar archivos
git add .

# Guardar cambios
git commit -m "Descripción del cambio"

# Subir a GitHub
git push origin main

Tu primer repositorio: manos a la obra

Vamos a crear tu primer proyecto con Git desde cero. Sigue estos pasos exactamente:

Paso 1: Crear el proyecto

# Crear carpeta
mkdir mi-primer-repo
cd mi-primer-repo

# Inicializar Git
git init

# Crear archivo README
echo "# Mi Primer Repositorio" > README.md

Paso 2: Tu primer commit

# Ver el estado
git status

# Agregar archivos
git add README.md

# Confirmar cambios
git commit -m "Primer commit: añadir README"

Paso 3: conectar con GitHub

1. Ve a github.com y crea una cuenta
2. Clic en "New repository"
3. Nombre: mi-primer-repo
4. Marca "Public" y clic en "Create repository"
5. Copia la URL que aparece (algo como https://github.com/tuusuario/mi-primer-repo.git)

Paso 4: subir a GitHub

# Conectar con GitHub
git remote add origin https://github.com/TUUSUARIO/mi-primer-repo.git

# Subir por primera vez
git push -u origin main

Ya tienes tu primer repositorio en GitHub, visible para cualquiera que busque tu perfil.

Tu primera contribución open source

La primera vez que hice un pull request me temblaban las manos, literal. Pensaba que iba a "romper" el proyecto de alguien o que me iban a echar la bronca en los comentarios. Spoiler: no pasa nada de eso. Vamos a contribuir a un repositorio pensado precisamente para que la gente pierda ese miedo.

¿Qué es una contribución open source?

Es cuando mejoras o añades algo a un proyecto público. Puede ser:

• Arreglar un bug
• Mejorar la documentación
• Añadir una nueva funcionalidad
• Mejorar el diseño

Paso a paso: tu primera contribución

1. Fork del proyecto

1. Ve a github.com/firstcontributions/first-contributions
2. Clic en "Fork" (esquina superior derecha)
3. Esto crea una copia del proyecto en tu cuenta

2. Clonar tu fork

git clone https://github.com/TUUSUARIO/first-contributions.git
cd first-contributions

3. Crear una rama nueva

git checkout -b add-tu-nombre

4. Hacer tu cambio

Abre el archivo Contributors.md y añade tu nombre al final de la lista:

- [Tu Nombre](https://github.com/tuusuario)

5. Guardar tu cambio

git add Contributors.md
git commit -m "Add [Tu Nombre] to Contributors list"

6. Subir tu rama

git push origin add-tu-nombre

7. Crear Pull Request

1. Ve a tu fork en GitHub
2. Aparecerá un botón "Compare & pull request"
3. Escribe una descripción de tu cambio
4. Clic en "Create pull request"

Errores comunes y cómo solucionarlos

Error 1: "Permission denied"

fatal: could not read Password for 'https://github.com'

Solución: Configura un token de acceso personal en GitHub Settings → Developer settings → Personal access tokens.

Error 2: "Your branch is ahead of 'origin/main'"

Solución: Haz git push para subir tus cambios.

Error 3: "Merge conflict"

Este es el que más pánico da la primera vez que lo ves, y es de los más comunes: dos personas tocaron la misma línea de código y Git no sabe cuál versión quieres.

Solución: Abre el archivo en conflicto, busca las líneas con <<<<<<< y >>>>>>>, decide qué código se queda (o combina ambos), borra esas marcas y haz commit. No hay atajo mágico, hay que leer el conflicto con calma.

Error 4: "Nothing to commit"

Solución: Verificar que has guardado los archivos y usar git add . antes de commit.

Próximos pasos con Git

Con esto tienes lo básico cubierto, pero Git da para mucho más. Un plan realista para las próximas semanas:

Cómo Git te ayuda a conseguir trabajo

Git no es solo una herramienta técnica, es parte de tu carta de presentación:

En tu portfolio

• Los reclutadores echan un vistazo a tu actividad en GitHub
• Tus commits muestran cómo escribes código, no solo qué código escribes
• Las contribuciones open source demuestran que sabes trabajar con código de otros

En entrevistas técnicas

• Te pueden pedir que expliques tu flujo de trabajo con Git
• A veces simulan trabajo en equipo con branches para ver cómo te mueves
• Es habitual que pregunten cómo resolverías un conflicto de merge

Si estás preparándote para tu primer trabajo en tech, complementa este conocimiento con nuestra guía completa para conseguir tu primer trabajo en tech.

Y ahora, a practicar

La teoría se olvida en una semana si no la usas. El siguiente paso concreto: coge cualquier proyecto que tengas a medias en tu ordenador, hazle git init, y súbelo a GitHub siguiendo los mismos pasos de este tutorial. No hace falta que sea nada especial — el objetivo es que el flujo add → commit → push se te quede en los dedos antes de meterte con conflictos de merge o ramas más avanzadas.

Recursos adicionales

• Learn Git Branching - Tutorial interactivo para visualizar ramas
• Pro Git Book - Documentación oficial en español
• First Contributions - Más práctica con open source

Continúa tu aprendizaje

El siguiente paso natural después de Git es aprender a construir cosas que merezca la pena subir a un repositorio:

• Crear formularios con HTML y CSS
• Manipular el DOM con JavaScript
• Seguir el roadmap completo de Frontend