Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/danielcruca/plataformas-abiertas-2026-2c/llms.txt

Use this file to discover all available pages before exploring further.

En esta guía aprenderás a configurar Git por primera vez, inicializar un repositorio local, registrar tus cambios con commits y publicar tu proyecto en GitHub. Seguirás 9 pasos ordenados que cubren tanto el trabajo en tu computadora como la integración con la nube.

​
Requisitos previos

​
Parte 1 — Uso de Git (local)

1

Configurar Git (solo la primera vez)

Abre una terminal y ejecuta los siguientes comandos reemplazando los valores con tu nombre y correo reales. Esta configuración se aplica de forma global a todos tus repositorios.
git config --global user.name "Tu Nombre"
git config --global user.email "tucorreo@example.com"
2

Crear una carpeta de proyecto y abrirla en VS Code

Crea una carpeta con el nombre de tu proyecto, por ejemplo:
C:\Users\TU-USUARIO\Documents\Proyectos\MI-NOMBRE-DE-PROYECTO
Abre esa carpeta con Visual Studio Code y accede a la terminal integrada desde el menú Terminal → New Terminal.
3

Inicializar el repositorio Git

Desde la terminal integrada de VS Code, estando dentro de la carpeta del proyecto, ejecuta:
git init
Esto crea una carpeta oculta .git que convierte la carpeta en un repositorio Git local.
4

Crear un archivo README.md

Crea un archivo llamado README.md en la raíz del proyecto con el siguiente contenido de ejemplo:
# Tareas Plataformas Abiertas

*Nombre de estudiante:* TU NOMBRE Y APELLIDOS.
También puedes crear una carpeta imagenes y colocar allí cualquier imagen de tu elección.
5

Agregar archivos al staging

El área de staging es donde preparas los archivos antes de confirmarlos. Para agregar todos los archivos del proyecto ejecuta:
git add .
Para verificar qué archivos fueron agregados:
git status
Los archivos listados en verde están listos para ser confirmados con un commit.
6

Hacer el primer commit

Un commit guarda una instantánea de los cambios en tu repositorio local. El parámetro -m permite agregar un mensaje descriptivo:
git commit -m "Primer commit"
Otros ejemplos de mensajes descriptivos:
git commit -m "Agregado soporte a base de datos."
# Otro ejemplo:
git commit -m "Arregla timeout en produccion."

​
Parte 2 — Integración con GitHub (en la nube)

1

Crear un repositorio en GitHub

  1. Ve a https://github.com
  2. Haz clic en Create repository
  3. Escribe el nombre del repositorio, por ejemplo: tareas-plataformas-abiertas
  4. Desmarca la opción Initialize this repository with a README (ya tienes uno local)
  5. Haz clic en Create repository
2

Conectar el repositorio local con GitHub

Copia la URL del repositorio recién creado en GitHub (termina en .git). Luego ejecuta estos dos comandos en tu terminal:
git branch -M main

git remote add origin https://github.com/TU-USUARIO/tareas-plataformas-abiertas.git
Esto renombra tu rama principal a main y enlaza tu repositorio local con el remoto en GitHub. La palabra origin es el nombre que le das a ese repositorio remoto.
3

Subir el proyecto a GitHub

Para subir tu proyecto por primera vez a la nube ejecuta:
git push -u origin main
Es posible que aparezca una pantalla para autenticarte con GitHub. Una vez completada, tu repositorio local y el remoto quedarán sincronizados.
Si tu rama principal se llama master en lugar de main, usa git push -u origin master solo en ese caso.

​
Flujo de trabajo habitual

Una vez que el repositorio ya está conectado a GitHub, el ciclo para agregar nuevos cambios se reduce a tres comandos: 
# 1. Agregar los cambios al área de staging (todos los archivos)
git add .
# O si solo querés agregar un archivo específico:
git add archivo-nuevo.py

# 2. Confirmar (commit) los cambios con un mensaje descriptivo
git commit -m "Agrega nueva función de búsqueda en app.py"

# 3. Enviar (push) los cambios al repositorio remoto, rama principal
git push origin main

​
Comandos útiles

Ver el estado actual de los archivos (sin cambios, en staging, sin confirmar): 
git status
Ver el historial de commits realizados en el repositorio: 
git log

​
Clonar un repositorio existente

Si el repositorio ya existe en GitHub y solo necesitás descargarlo, usá git clone. Por ejemplo, para clonar el repositorio de este curso: 
git clone https://github.com/danielcruca/plataformas-abiertas-2026-2c.git
Una vez clonado, el repositorio ya está vinculado al remoto y podés trabajar con él de inmediato.

​
Agregar colaboradores

Para trabajar de forma colaborativa, podés agregar otros usuarios como colaboradores de tu repositorio:
  1. Ve a la página de tu repositorio en GitHub
  2. Haz clic en Settings (Configuración)
  3. En el menú lateral selecciona Manage access
  4. Haz clic en Add people e ingresa el nombre de usuario de GitHub de tu colaborador
Solo los administradores del repositorio pueden agregar colaboradores. El nombre de usuario del profesor del curso es danielcruca.

Build docs developers (and LLMs) love

Get started for freeTalk to us