Práctica — Primer repositorio, commit y push (perfil de GitHub)

Ultima actualización: 14/Ago/2026

Objetivo

Practicar el flujo básico de Git y GitHub (crear repositorio → clonar → commit → push) creando un artefacto real y útil: el README de perfil de GitHub, esa página especial que aparece en la parte superior de su perfil (github.com/su-usuario).

Criterio de éxito: cada estudiante tiene un repositorio público en su cuenta de GitHub, con el mismo nombre que su usuario, clonado en su computador, con al menos un commit hecho localmente y subido (push) a GitHub, y el README se ve renderizado en su perfil.

Prerequisito

Tener Git instalado y configurado (user.name, user.email) y una cuenta de GitHub. Ver Práctica — Configuración del entorno de desarrollo si aún no lo ha hecho.

¿Qué es el repositorio especial de perfil?

GitHub permite crear un repositorio con un nombre muy particular: igual a su nombre de usuario. Si ese repositorio es público y tiene un archivo README.md en la raíz, GitHub muestra automáticamente ese contenido en la parte superior de su perfil.

Ejemplo: si su usuario es su-usuario, el repositorio se debe llamar exactamente su-usuario (mismas mayúsculas/minúsculas que su usuario).

Documentación oficial: Managing your profile README (GitHub Docs). Ejemplo con inspiración e ideas de contenido: How to Create a Personalized GitHub Profile Page (freeCodeCamp).

Paso 1 — Crear el repositorio en GitHub

Inicie sesión en github.com.
Haga clic en el botón New (o el + en la esquina superior derecha → New repository).
En Repository name escriba exactamente su nombre de usuario de GitHub (respetando mayúsculas/minúsculas). GitHub va a mostrar un mensaje especial: “‎This is a special repository” / “You found a secret repository” confirmando que activa el README de perfil.
Marque la opción Public (debe ser público para que aparezca en el perfil).
Marque la casilla Add a README file.
Haga clic en Create repository.

Si el nombre del repositorio no coincide exactamente con su usuario, o si el repositorio es privado, GitHub no lo mostrará como perfil — quedará como un repositorio normal.

Paso 2 — Clonar el repositorio en local

Copie la URL del repositorio (botón verde Code → HTTPS) y clónelo en su computador:

git clone https://github.com/su-usuario/su-usuario.git
cd su-usuario

Reemplace su-usuario por su nombre de usuario real de GitHub en ambos lugares (nombre del repo y carpeta).

Verifique que el README.md que creó GitHub ya está en su carpeta local:

Paso 3 — Editar el README y hacer el primer commit

Abra README.md con su editor (VS Code o el que use) y agregue contenido básico sobre usted. Como mínimo:

### Hola, soy [Su Nombre] 👋

- 🎓 Estudiante de la Maestría en Ciencia de Datos — UPB
- 💻 Actualmente aprendiendo Ciencia de Datos en Producción
- 🌱 Intereses: (agregar 2-3 temas: NLP, MLOps, visión por computador, etc.)
- 📫 Cómo contactarme: (correo, LinkedIn, o el medio que prefiera)

Ideas adicionales para enriquecerlo después (no obligatorias para esta práctica): badges de tecnologías, estadísticas de GitHub (GitHub Stats card), lista de proyectos destacados. Ver ejemplos en el artículo de freeCodeCamp.

Guarde el archivo y haga el commit:

git add README.md
git commit -m "docs: agregar contenido inicial al README de perfil"

Note el formato del mensaje de commit: tipo: descripción corta. Esto es Conventional Commits, que se explica en detalle en Commits y Conventional Commits. Para esta práctica basta con docs: porque solo estamos documentando/escribiendo texto.

Paso 4 — Push al repositorio remoto

Suba el commit a GitHub:

git push origin main

Si Git le pide autenticación, siga las instrucciones de Configuración de Git y autenticación (GitHub Docs).

Paso 5 — Verificar en el navegador

Vaya a https://github.com/su-usuario (reemplace por su usuario).
Debe ver su README renderizado justo encima de la lista de repositorios.
Vaya también a https://github.com/su-usuario/su-usuario y confirme que el commit aparece en el historial (git log local también lo muestra).

Checklist de pasos

Repositorio creado en GitHub con nombre exacto igual al usuario, público, con README inicial
Repositorio clonado en local (git clone)
README editado con contenido básico sobre el estudiante
Commit hecho localmente con mensaje tipo Conventional Commits (docs: ...)
git push completado sin error
README visible en github.com/su-usuario