47 lines
1.6 KiB
Markdown
47 lines
1.6 KiB
Markdown
# Cómo contribuir
|
|
|
|
¡Gracias por querer ayudar! El proyecto se mantiene gracias a la comunidad.
|
|
|
|
## Antes de empezar
|
|
|
|
1. Mira los [issues abiertos](../../issues), sobre todo los marcados
|
|
`good first issue`.
|
|
2. Si tu cambio es grande, abre un issue antes de programar para discutirlo.
|
|
|
|
## Flujo
|
|
|
|
1. Haz fork del repositorio.
|
|
2. Crea una rama desde `main`: `git checkout -b mi-cambio`.
|
|
3. Escribe el código siguiendo las pautas de abajo.
|
|
4. Asegúrate de que la app arranca: `npm install && npm run dev`.
|
|
5. Abre un Pull Request hacia `main` describiendo el cambio.
|
|
|
|
## Pautas de código
|
|
|
|
- **Mantén la app simple.** Si dudas entre dos soluciones, elige la más corta
|
|
y obvia. Este proyecto evita la complejidad a propósito.
|
|
- **Sigue la estructura existente.** Componentes en `src/components`, acceso a
|
|
datos en `src/services`.
|
|
- **No añadas dependencias sin necesidad.** Cada nueva librería es coste de
|
|
mantenimiento.
|
|
- **SOLID y Clean Code aplicados con sentido común.** Nombres claros,
|
|
funciones cortas, una responsabilidad por archivo.
|
|
- **Estilo**: 2 espacios de indentación, comillas dobles en JSX y simples en JS.
|
|
|
|
## Tipos de contribución
|
|
|
|
- **Código**: bugs, mejoras, nuevas funciones acordadas en issues.
|
|
- **Documentación**: cualquier archivo de `docs/` o el README.
|
|
- **Diseño**: propuestas en issues con mockups.
|
|
- **Reportar negocios**: usa la propia aplicación; no es necesario un PR.
|
|
|
|
## Revisión
|
|
|
|
Un mantenedor revisará tu PR. Puede pedir cambios. Una vez aprobado, hará
|
|
merge. Sé paciente: somos voluntarios.
|
|
|
|
## Reconocimiento
|
|
|
|
Todas las personas que han contribuido aparecen automáticamente en la pestaña
|
|
de Contributors del repositorio.
|