Contribution Guidelines

Seja open-source ou interno, repos Solana precisam de regras claras de contribuição: quem revisa mudanças de programa, como propor ADRs e como este guia aceita correções de artigos.

Receita

Cartão de receita para referência rápida - pronto para copiar e colar.

## PR checklist
- [ ] Tests pass (anchor test / LiteSVM)
- [ ] IDL updated if program interface changed
- [ ] ADR linked if architectural
- [ ] Runbook updated if ops changed
- [ ] No secrets in diff

Quando usar:

• Publicar CONTRIBUTING.md no GitHub
• Onboarding de contractors
• Lançamento de comunidade open-source
• Correção do guia por leitor

Exemplo Prático

# CONTRIBUTING.md (excerpt)
 
## Branches
- `main` protected; require 2 approvals on `programs/`
- Feature: `feat/withdraw-v2`
 
## Commits
feat(lending): add withdraw_v2 instruction
fix(client): bigint amount parsing
docs(incident): update pause runbook
 
## Security
security@company.com - do not open public issues for exploits

# CODEOWNERS
programs/           @solana-team-leads
docs/runbooks/      @sre-oncall
site/solana/        @docs-maintainers

O que isso demonstra:

• Proteção de branch alinhada ao risco
• Conventional commits para release notes
• Canal privado de segurança
• Roteamento CODEOWNERS

Aprofundamento

Tipos de contribuição

Contribuições ao guia

• Corrija erros factuais via PR em site/solana/
• Corresponda versões da stack em manifest.json
• Sem em dash; footer da stack na última linha

Erros comuns

• PR de programa drive-by sem contexto - Rejeite educadamente; exija link RFC. Correção: Template CONTRIBUTING.
• Issue pública de exploit - Risco de copycat. Correção: Política de segurança em destaque.
• Docs sem lint - Links quebrados vão para produção. Correção: CI lint-docs como check obrigatório.
• Dependência sem licença - Risco jurídico. Correção: Allowlist de licença em cargo deny.
• Force push em main - Incidente à espera. Correção: Proteção de branch.

Alternativas

FAQs

Relacionados

• Documentation Conventions - onde docs vivem
• Coding & Program Standards - estilo de código
• Audit & Bug-Bounty Program - intake de segurança

Versões da stack: Esta página foi escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0 e LiteSVM 0.6.x.