CONTRIBUIR
Patches que aceitamos. Patches que recusamos.
Processo de contribuição aberto — um pouco exigente quanto à disciplina, nunca quanto a quem você é.
Escolha algo para trabalhar
O repositório rotula issues de primeiro contato como good-first-issue. Os mantenedores fazem a triagem para confirmar que o escopo é justo e os passos são claros. Se você terminar uma, deixe o rótulo — isso ajuda a próxima pessoa.
Para trabalhos maiores, abra uma discussão primeiro. Diremos sim, não, ou ainda não, eis o porquê. Dizer não faz parte de respeitar o seu tempo.
Assine seus commits
shell# in your local clone
git config user.signingkey YOUR_KEY_FINGERPRINT
git config commit.gpgsign true
git config tag.gpgsign trueExigimos commits assinados com GPG. Não se trata de erguer barreiras — trata-se de manter honesta a cadeia de suprimentos do projeto. Se você ainda não tem uma chave, o wiki do repositório guia você na geração de uma.
Signed-off-by: Name <email>). Use git commit -s para adicioná-lo automaticamente.Escreva uma mensagem de commit convencional
commit messagefeat(lsia): emit telemetry on safe-mode entry
Adds a single counter when the immune-system engine enters safe mode.
The counter is hashed-pattern only and respects the privacy gate.
Refs: #842
Signed-off-by: A. Researcher <a@example.org>Seguimos a Conventional Commits na primeira linha. O corpo explica o porquê. O rodapé referencia issues ou mudanças relacionadas.
Abra o pull request
Pull requests passam por três crivos automatizados e uma revisão humana:
- A verificação de build reproduzível confere que seu patch não quebra o determinismo.
- O crivo de privacidade confere que nenhum caminho de dados brutos foi introduzido.
- A suíte de testes unitários e de integração precisa passar.
- Dois revisores aprovam antes do merge. Áreas sensíveis à segurança exigem um revisor de segurança.
Reconhecimento
Toda contribuição aceita aparece nas próximas notas de lançamento — com crédito, a menos que você peça anonimato. O arquivo AUTHORS é atualizado automaticamente na primeira vez que você faz um merge.
Para trabalhos maiores — um recurso importante, uma auditoria, uma tradução — a entrada do changelog menciona você pelo nome. O crédito anônimo é um pedido normal, não um especial.
Código de conduta
Seguimos o Contributor Covenant 2.1. Ataques pessoais, ameaças, doxxing e assédio são violações de remoção imediata, sem necessidade de cadeia de queixas. O texto completo está no CODE_OF_CONDUCT.md do repositório.