Una página web colaborativa donde desarrolladores de todo el mundo pueden contribuir con su información personal y aprender sobre colaboración en proyectos open source.
Al participar en este proyecto, practicarás y aprenderás:
- 🍴 Forking: Crear una copia del repositorio en tu cuenta
- 🌿 Branching: Crear y manejar ramas para organizar tu trabajo
- 📝 Commits: Guardar cambios con mensajes descriptivos
- ⬆️ Push/Pull: Sincronizar cambios entre local y remoto
- 🔄 Pull Requests: Proponer cambios para revisión
- 🤝 Merge: Integrar cambios al proyecto principal
// Agregar tu información personal al proyecto
{
name: "Tu Nombre Completo",
nickname: "tu-github-username",
github: "https://github.com/tu-username",
linkedin: "https://linkedin.com/in/tu-perfil", // Opcional
description: "Breve descripción profesional (máx. 150 caracteres)",
hobbies: ["Hobby1", "Hobby2", "Hobby3", "Hobby4"] // Máximo 4
}- Configuración de Entorno → Git, GitHub, editor de código
- Workflow de Fork → Cómo trabajar con copias de repositorios
- Gestión de Ramas → Organizar trabajo en features separadas
- Commits Semánticos → Escribir mensajes claros y descriptivos
- Pull Request Process → Proponer y discutir cambios
- Code Review → Recibir feedback y mejorar código
- Continuous Integration → Validaciones automáticas
- Merge y Deploy → Ver tu trabajo en producción
flowchart TD
A[🌐 1. Accede al Repositorio] --> B[🍴 2. Haz Fork del Repo]
B --> C[📥 3. Clona tu Fork localmente]
C --> D[⚙️ 4. Configura Git<br/>user.name y user.email]
D --> E[🌿 5. Crea nueva rama<br/>feat/add-tu-nickname]
E --> F[📝 6. Abre el editor<br/>Localiza contributors-data.js]
F --> G[✏️ 7. Agrega tu información<br/>Verifica formato JSON]
G --> H[💾 8. Guarda y sube cambios<br/>git add, commit, push]
H --> I[🔄 9. Crea Pull Request<br/>desde tu rama]
I --> J[🤖 10. Validación Automática<br/>Formato, sintaxis, duplicados]
J --> K{¿Validación exitosa?}
K -->|❌ No| L[📝 Corrige errores<br/>según comentarios]
L --> H
K -->|✅ Sí| M[🎉 11. Auto-merge<br/>¡Apareces en la web!]
style A fill:#e1f5fe
style M fill:#e8f5e8
style J fill:#fff3e0
style K fill:#fce4ec
style L fill:#ffebee
| Paso | Acción | Comando Git |
|---|---|---|
| 1-2 | Fork en GitHub | (Botón Fork en GitHub) |
| 3 | Clonar fork | git clone https://github.com/TU_USUARIO/RepoColaborativo.git |
| 4 | Configurar Git | git config --global user.name "Tu Nombre" |
| 5 | Crear rama | git checkout -b feat/add-tu-nickname |
| 6-7 | Editar archivo | Modificar contributors-data.js |
| 8 | Subir cambios | git add . && git commit -m "feat: add tu-nickname" && git push origin feat/add-tu-nickname |
| 9 | Crear PR | (GitHub UI) |
| 10-11 | Automático | Sistema valida y mergea |
Cuando envíes tu PR, el sistema automáticamente validará:
- ✅ Sintaxis JavaScript correcta
- ✅ Formato de datos válido
- ✅ Campos requeridos completos
- ✅ Máximo 4 hobbies
- ✅ URL de LinkedIn válida (si se proporciona)
- ✅ No duplicación de nicknames
- Recibirás comentarios específicos sobre qué corregir
- El PR no será mergeado hasta que se corrijan los errores
- Puedes hacer commits adicionales para corregir
- Modificar únicamente
contributors.js - Agregar exactamente 1 colaborador por PR
- Usar tu propio GitHub username como nickname
- Incluir información real y profesional
- Modificar otros archivos (HTML, CSS, JS principal)
- Agregar múltiples colaboradores en un solo PR
- Usar información falsa o inapropiada
- Duplicar nicknames existentes
¿Quieres contribuir con código? También aceptamos:
- 🐛 Corrección de bugs
- ✨ Nuevas características
- 📖 Mejoras en documentación
- 🎨 Mejoras de diseño
Para estas contribuciones, abre un issue primero para discutir los cambios.