Contribuir

Chinaski tiene licencia MIT y se desarrolla en GitHub. Las contribuciones (correcciones de bugs, features, documentación) son bienvenidas.

Antes de empezar

Para cualquier cosa más allá de una corrección pequeña, abre primero un issue para acordar el enfoque antes de escribir código. Busca en los issues existentes y en los PRs abiertos para no duplicar trabajo en curso.

Configuración local

apt-get install -y perl make gcc sqlite3 libjpeg-dev libpng-dev libgif-dev
cpanm --installdeps .
sqlite3 chinaski.db < schema.sql
morbo cms.pl          # admin server
perl builder/build.pl # static output

Ejecutar las pruebas

CI ejecuta prove -lr t/ en un runner autoalojado en cada push a main y en cada pull request; debe pasar antes del merge. Consulta la sección Pruebas para el harness completo.

Convenciones

• Nombres de rama: type/short-description, usando fix/, feature/ o chore/, a menudo con el/los número(s) de ticket relevante(s) al final.
• Los mensajes de commit siguen Conventional Commits: fix(scope): what changed, feat(scope): what changed, chore: what changed.
• Los pull requests apuntan a main.

Contribuciones asistidas por IA

Las contribuciones asistidas por IA son esperadas, no solo toleradas. Chinaski fue escrito con Claude Code y Kimi y se mantiene de la misma manera: la fluidez con IA es la habilidad de contribución relevante; la fluidez en Perl no es un requisito. Indícalo en la descripción de tu PR si un agente de código hizo el trabajo; no hace falta ocultarlo.

Reportar bugs y solicitar features

Usa GitHub Issues en el repositorio.

Licencia

Al enviar un pull request aceptas que tu contribución se licencia bajo la licencia MIT del proyecto. Hoy no se requiere ningún CLA.

En esta sección

• Pruebas