Git&GitHubWorkshop

1

Accede y Forkea el Repositorio

Ve al repositorio oficial en GitHub y familiarízate con el proyecto. Revisa el README y la estructura del proyecto. Luego dale click a Fork y crear un fork del repositorio.

Paso 1: Acceder al repositorio
# URL del repositorio
https://github.com/Dav082004/RepoColaborativo
2

Haz Fork del Repositorio

Haz clic en el botón "Fork" en la esquina superior derecha del repositorio. Esto creará una copia del proyecto en tu cuenta de GitHub.

Paso 2: Fork del repositorio

El fork te permite trabajar en tu propia copia sin afectar el original.

3

Clona tu Fork

Verificar que se forkeo y esta en tu perfil ya que debe decir tu_perfil / RepoColaborativo
Despues clona tu fork a tu computadora local para poder trabajar en él. Usa el botón "Code" y copia la URL.

Paso 3: Clonar el fork
# Clona tu fork (reemplaza TU_USUARIO)
git clone https://github.com/TU_USUARIO/RepoColaborativo.git
cd RepoColaborativo
4

Configura Git

Configura tu información de Git si no lo has hecho antes. Esto es importante para identificar tus commits. Despues cuando estes en la carpeta donde quieras clonar tu repo forkeado tienes que escribir git clone (URL de tu fork)

Paso 4: Configurar Git

Nota: Asegurate de que este configurado correctamente

# Configura tu nombre y email
git config --global user.name "Tu Nombre"
git config --global user.email "tu-email@ejemplo.com"

# Verifica la configuración
git config --list
5

Crea una Nueva Rama

Crea una rama específica para tu contribución. Esto mantiene tu trabajo organizado y separado de la rama principal. Si te das cuenta sale como (main) eso hace referencia a la rama actual donde estas, es por eso que cuando creas una nueva rama en este caso se llama new-profile, donde salia main ahora dice new-profile entonces con eso confirmacion el cambio de rama

Paso 5: Crear nueva rama
# Crea y cambia a una nueva rama
git checkout -b feat/add-tu-nickname

# Verifica que estás en la nueva rama
git branch
6

Abre el Editor de Código

Abre el proyecto en tu editor favorito (VS Code, Sublime, etc.). Ahora que estás en una nueva rama, crea un archivo tu-nickname.json dentro de la carpeta contributors. Agrega tu información: nombre, nickname, GitHub, LinkedIn, Instagram (opcionales), imagen (puedes usar tu avatar de GitHub agregando .png), descripción y hasta 4 hobbies.

Paso 6: Abrir editor
# Si usas VS Code
code .

Puedes encontrar el template en templates/contributor-template.json. Recuerda que JSON no 
permite comentarios, así que debes quitar las líneas con // del template.
7

Verifica y sube tus Cambios

Revisa que tus cambios sean correctos y que no hayas modificado accidentalmente otras partes del archivo.

Paso 7: Verificar cambios
# Ver qué archivos han cambiado
git status

# Para juntar todos los cambios
git add .

# Para guardar los cambios
git commit -m "feat: add new profile for [tu-nickname]"

# Para subir a tu repositorio tu rama con cambios
git push origin feat/new-tu-nickname
8

Comparar y Pull Request

Verifica que ahora tienes 2 ramas en tu repositorio. GitHub te permitirá "Comparar y hacer Pull Request". Puedes ver que el último autor del cambio fuiste tú. Haz clic en el botón verde "Compare & pull request".

Paso 8: Comparar y PR

GitHub detecta automáticamente tu nueva rama y te permite crear el PR

9

Crear Pull Request

Verifica que el Pull Request se hará entre el repositorio principal y la rama main, mergeando los cambios de tu repo forkeado y tu nueva rama. Agrega un mensaje descriptivo explicando tus cambios y haz clic en "Create Pull Request".

Paso 9: Crear PR
9.1

Revisar Cambios en Código

Puedes revisar todos los cambios realizados en código antes de finalizar el Pull Request. Esto te permite verificar que todo esté correcto.

Paso 9.1: Ver cambios en código
10

Pull Request Abierta

Tu PR está ahora abierta para revisión. Las personas con roles suficientes pueden comentar, rechazar o aprobar la PR.

Paso 10: PR abierta
11

Aprobación y Merge

Cuando no hay conflictos y todo está correcto, un revisor puede aprobar la PR y hacer el merge. Tus cambios serán integrados al repositorio principal.

Paso 11: Aprobación y merge
12

Historial de Commits

Puedes ver el historial de commits donde aparece tu commit junto con el commit del auditor que aprobó los cambios. Tu contribución forma parte oficial del proyecto.

Paso 12: Historial de commits
13

¡Felicitaciones!

¡Tu contribución ha sido exitosa! Ahora apareces en la página colaborativa con tu perfil, información y enlaces. Eres oficialmente parte del proyecto.

Paso 13: Resultado final

¡Has completado tu primera contribución!

  • Fork realizado correctamente
  • Repositorio clonado localmente
  • Rama nueva creada siguiendo GitFlow
  • Cambios realizados y commitados
  • Pull Request creado y aprobado
  • 🎉 ¡Apareces en la página!

Sistema de Validación Automática

Validación de Formato

El sistema verifica que el formato de tu contribución sea correcto y que todos los campos requeridos estén presentes.

Auto-merge

Si todas las validaciones pasan, tu PR será automáticamente mergeado y aparecerás en la página principal.

Corrección de Errores

Si hay errores, recibirás comentarios específicos sobre qué corregir. Puedes hacer nuevos commits para solucionarlos.

Ejemplos de Contribución

Ejemplo Correcto

{
  name: "Ana María González",
  nickname: "anagonzalez",
  github: "https://github.com/anagonzalez",
  linkedin: "https://linkedin.com/in/ana-gonzalez-dev",
  description: "Estudiante de Ingeniería de Sistemas especializada en desarrollo web",
  hobbies: ["Programación", "Lectura", "Yoga", "Fotografía"]
},

Errores Comunes

Falta la coma al final del objeto
URL de GitHub incompleta o incorrecta
Más de 4 hobbies en el array
Descripción demasiado larga (más de 150 caracteres)
Nickname duplicado (ya existe en el sistema)