DocumentaçãoCONTRIBUIR

CONTRIBUIR

Patches que aceitamos. Patches que recusamos.

Processo de contribuição aberto — um pouco exigente quanto à disciplina, nunca quanto a quem você é.

01

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.

02

Assine seus commits

shell# in your local clone
git config user.signingkey YOUR_KEY_FINGERPRINT
git config commit.gpgsign true
git config tag.gpgsign true

Exigimos 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.

Linha de sign-off
Toda mensagem de commit deve terminar com um sign-off de Developer Certificate of Origin (Signed-off-by: Name <email>). Use git commit -s para adicioná-lo automaticamente.
03

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.

04

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.
Se o crivo de privacidade falhar
Pare. Releia o diff com cuidado — o teste falha quando um caminho de código poderia vazar identificadores brutos (IP, e-mail, IMEI, GPS). A correção quase nunca é desativar o teste.
05

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.

06

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.