Contribuindo

O Chinaski tem licença MIT e é desenvolvido no GitHub. Contribuições (correções de bugs, funcionalidades, documentação) são bem-vindas.

Antes de começar

Para qualquer coisa além de uma pequena correção, abra primeiro uma issue para combinar a abordagem antes de escrever código. Pesquise as issues existentes e os PRs abertos para não duplicar trabalho em andamento.

Configuração 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

Executando os testes

O CI executa prove -lr t/ em um runner auto-hospedado a cada push para main e a cada pull request; ele precisa passar antes do merge. Veja a seção Testes para o harness completo.

Convenções

• Nomes de branch: tipo/descricao-curta, usando fix/, feature/ ou chore/, muitas vezes com o(s) número(s) do ticket relevante(s) no final.
• As mensagens de commit seguem o Conventional Commits: fix(scope): what changed, feat(scope): what changed, chore: what changed.
• Os pull requests têm main como alvo.

Contribuições assistidas por IA

Contribuições assistidas por IA são esperadas, não apenas toleradas. O Chinaski foi escrito com Claude Code e Kimi e é mantido da mesma forma: fluência em IA é a habilidade de contribuição relevante; fluência em Perl não é um requisito. Diga isso na descrição do seu PR se um agente de código fez o trabalho; não é preciso esconder.

Reportando bugs e solicitando funcionalidades

Use as GitHub Issues do repositório.

Licença

Ao enviar um pull request, você concorda que sua contribuição é licenciada sob a licença MIT do projeto. Nenhum CLA é exigido hoje.

Nesta seção

• Testes