## GUÍA DE CONTRIBUCIÓN

### 1. Filosofía de Contribución

En EgoCX, creemos que las mejores ideas vienen de colaborar con personas que comparten nuestra pasión por la identidad digital auténtica y el diseño bien hecho.

**Nuestros principios:**
- **Respeto** — todas las voces son bienvenidas
- **Calidad** — cada contribución debe cumplir con nuestros estándares
- **Transparencia** — el proceso es abierto y claro
- **Aprendizaje** — contribuir es una oportunidad de crecer

---

### 2. Cómo Contribuir

#### 2.1. Reportar un Problema (Issue)
Si encuentras algo que no funciona como esperabas:

1. Busca en los issues existentes para ver si ya se reportó
2. Si no existe, crea uno nuevo con:
   - **Título claro** (máximo 70 caracteres)
   - **Descripción detallada** (qué esperabas vs. qué pasó)
   - **Pasos para reproducir** (si aplica)
   - **Capturas de pantalla** (si es visual)
   - **Contexto** (navegador, sistema operativo, versión)

#### 2.2. Sugerir una Mejora
Si tienes una idea para mejorar EgoCX:

1. Describe la mejora con claridad
2. Explica *por qué* es una buena idea
3. Si es posible, ofrece un ejemplo o prototipo

#### 2.3. Enviar un Pull Request
Si quieres contribuir con código:

1. **Fork** del repositorio
2. **Clona** tu fork localmente
3. Crea una **rama** con un nombre descriptivo (`feature/nueva-funcion` o `fix/error-envio`)
4. Haz tus **cambios** siguiendo la guía de estilo
5. **Prueba** tus cambios (unitarias, integración)
6. **Documenta** los cambios en el README o comentarios
7. **Envía** un Pull Request con una descripción clara

---

### 3. Guía de Estilo para Contribuciones

#### 3.1. Código
- Sigue las reglas de `copilot.md / developer.md`
- Usa nombres descriptivos para variables y funciones
- Mantén las funciones pequeñas y enfocadas
- Escribe tests para el código nuevo

#### 3.2. UX Writing / Copy
- Sigue las reglas de `copy.md / ux-writing.md`
- Usa el tono de marca: cercano, optimista, realista
- Mantén las frases cortas y claras

#### 3.3. Documentación
- Usa Markdown para la documentación
- Explica *qué* hace el código y *por qué* está ahí
- Incluye ejemplos cuando sea posible
- Mantén la documentación actualizada con los cambios

---

### 4. Código de Conducta

Todos los participantes deben:

- **Ser respetuosos** — con ideas, opiniones y personas
- **Ser constructivos** — enfocados en soluciones, no en problemas
- **Ser abiertos** — a ideas diferentes y colaboración
- **Ser responsables** — de sus palabras y acciones

**No se tolerará:**
- Acoso o intimidación
- Comentarios ofensivos o discriminatorios
- Comportamiento tóxico o disruptivo

Los infractores serán bloqueados del proyecto.

---

### 5. Proceso de Revisión

1. **Triage:** Un miembro del equipo revisa el issue o PR
2. **Evaluación:** Se valida la propuesta o los cambios
3. **Feedback:** Se dan comentarios constructivos
4. **Aprobación:** Si cumple con los estándares, se aprueba
5. **Fusión:** Se integra al repositorio principal

---

### 6. Reconocimiento

Valoramos cada contribución. Los colaboradores serán reconocidos en:

- El `README.md` del repositorio
- Las notas de versión (changelog)
- Nuestros canales de comunicación (con su permiso)

---

*Última actualización: 2026-07-10*