Política de contribuição

translation: human page_type: lcat

Esta página aborda o modelo de governança e a política de contribuição do Bazel.

Modelo de governança

O projeto do Bazel é liderado e gerenciado pelo Google e tem uma grande comunidade de colaboradores fora do Google. Alguns componentes do Bazel (como repositórios de regras específicas na organização bazelbuild) são liderados, mantidos e gerenciados por membros da comunidade. A equipe do Google Bazel analisa sugestões para adicionar repositórios de propriedade da comunidade (como regras) à bazelbuild organização do GitHub.

Funções do colaborador

Confira a seguir os papéis no projeto do Bazel, incluindo as responsabilidades:

  • Proprietários: a equipe do Google Bazel. Os proprietários são responsáveis por:
    • Estratégia, manutenção e liderança do projeto do Bazel.
    • Criar e manter a funcionalidade principal do Bazel.
    • Nomear mantenedores e aprovar novos repositórios.
  • Mantenedores: a equipe do Google Bazel e usuários designados do GitHub. Os mantenedores são responsáveis por:
    • Criar e manter a funcionalidade principal do repositório.
    • Analisar e aprovar contribuições para áreas da base de código do Bazel.
    • Oferecer suporte a usuários e colaboradores com gerenciamento de problemas, revisão de PR e documentação oportunos e transparentes.
    • Lançar, testar e colaborar com os proprietários do Bazel.
  • Colaboradores: todos os usuários que contribuem com código ou documentação para o projeto do Bazel.
    • Criar PRs bem escritos para contribuir com a base de código e a documentação do Bazel.
    • Usar canais padrão, como problemas do GitHub, para propor mudanças e informar problemas.

Como se tornar um mantenedor

Os proprietários do Bazel podem nomear mantenedores para liderar áreas de código bem definidas, como conjuntos de regras. Os colaboradores com um histórico de contribuições consistentes e responsáveis que planejam grandes contribuições no futuro podem ser considerados para se tornarem mantenedores qualificados.

Política de contribuição

O projeto do Bazel aceita contribuições de colaboradores externos. Confira as políticas de contribuição para áreas de código gerenciadas pelo Google e pela comunidade.

  • Licenciamento. Todos os mantenedores e colaboradores precisam assinar o Contrato de licença de colaborador do Google.
  • Contribuições. Os proprietários e mantenedores precisam fazer todos os esforços para aceitar contribuições valiosas. Todas as contribuições precisam ser:
    • Bem escritas e bem testadas
    • Discutidas e aprovadas pelos mantenedores da área de código relevante. As discussões e aprovações acontecem em problemas e PRs do GitHub. Contribuições maiores exigem uma revisão de design.
    • Adicionadas ao sistema de integração contínua do Bazel, se ainda não estiverem presentes.
    • Compatíveis e alinhadas à direção do produto do Bazel
  • Revisão de código. Todas as mudanças em todos os repositórios bazelbuild exigem revisão:
    • Todos os PRs precisam ser aprovados por um proprietário ou mantenedor.
    • Somente proprietários e mantenedores podem mesclar PRs.
  • Compatibilidade. Os proprietários podem precisar rejeitar ou solicitar modificações em PRs no caso improvável de que a mudança exija modificações substanciais nos sistemas internos do Google.
  • Documentação. Quando relevante, as contribuições de recursos precisam incluir atualizações de documentação.

Para mais detalhes sobre como contribuir com o Bazel, consulte nossas diretrizes de contribuição.