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.
# URL del repositorio
https://github.com/Dav082004/RepoColaborativo
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.
El fork te permite trabajar en tu propia copia sin afectar el original.
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.
# Clona tu fork (reemplaza TU_USUARIO)
git clone https://github.com/TU_USUARIO/RepoColaborativo.git
cd RepoColaborativo
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)
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
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
# Crea y cambia a una nueva rama
git checkout -b feat/add-tu-nickname
# Verifica que estás en la nueva rama
git branch
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.
# 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.
Verifica y sube tus Cambios
Revisa que tus cambios sean correctos y que no hayas modificado accidentalmente otras partes del archivo.
# 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
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".
GitHub detecta automáticamente tu nueva rama y te permite crear el PR
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".
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.
Pull Request Abierta
Tu PR está ahora abierta para revisión. Las personas con roles suficientes pueden comentar, rechazar o aprobar la PR.
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.
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.
¡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.
¡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"]
},