Contribuer

Chinaski est sous licence MIT et développé sur GitHub. Les contributions (corrections de bugs, fonctionnalités, docs) sont les bienvenues.

Avant de commencer

Pour tout ce qui dépasse une petite correction, ouvrez d'abord une issue afin de vous accorder sur l'approche avant d'écrire du code. Recherchez dans les issues existantes et les PR ouvertes pour ne pas dupliquer un travail en cours.

Installation locale

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

Lancer les tests

La CI exécute prove -lr t/ sur un runner auto-hébergé pour chaque push vers main et chaque pull request ; elle doit passer avant la fusion. Voir la section Tests pour le harnais complet.

Conventions

• Noms de branches : type/short-description, en utilisant fix/, feature/ ou chore/, souvent avec le ou les numéros de ticket concernés à la fin.
• Les messages de commit suivent Conventional Commits : fix(scope): what changed, feat(scope): what changed, chore: what changed.
• Les pull requests ciblent main.

Contributions assistées par IA

Les contributions assistées par IA sont attendues, pas seulement tolérées. Chinaski a été écrit avec Claude Code et Kimi et est maintenu de la même façon : la maîtrise de l'IA est la compétence de contribution pertinente, la maîtrise de Perl n'est pas une exigence. Dites-le dans la description de votre PR si un agent de code a fait le travail ; il n'y a pas besoin de le cacher.

Signaler des bugs et demander des fonctionnalités

Utilisez GitHub Issues sur le dépôt.

Licence

En soumettant une pull request, vous acceptez que votre contribution soit sous licence MIT du projet. Aucun CLA n'est requis aujourd'hui.

Dans cette section

• Tests