Política de contribuição

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

Modelo de governança

O projeto 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 sob a organização bazelbuild ) são conduzidos, 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) à organização do GitHub do bazelbuild .

Funções do colaborador

Aqui estão os esboços das funções no projeto Bazel, incluindo suas 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 Bazel.
    • Construindo e mantendo 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:
    • Construindo e mantendo a funcionalidade primária de seu repositório.
    • Revisão e aprovação de contribuições para áreas da base de código Bazel.
    • Apoiar usuários e colaboradores com gerenciamento de problemas, revisão de relações públicas e documentação oportuna e transparente.
    • Liberando, testando e colaborando com os proprietários do Bazel.
  • Contribuidores : Todos os usuários que contribuem com código ou documentação para o projeto Bazel.
    • Criação de PRs bem escritos para contribuir com a base de código e documentação do Bazel.
    • Usando canais padrão, como problemas do GitHub, para propor alterações e relatar problemas.

Tornando-se um mantenedor

Os Proprietários do Bazel podem nomear Mantenedores para liderar áreas de código bem definidas, como conjuntos de regras. Contribuintes com um registro de contribuições passadas consistentes e responsáveis ​​que estão planejando grandes contribuições no futuro podem ser considerados Mantenedores qualificados.

Política de contribuição

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

  • Licenciamento . Todos os Mantenedores e Colaboradores devem assinar o Contrato de Licença de Colaborador do Google .
  • Contribuições . Proprietários e mantenedores devem fazer todos os esforços para aceitar contribuições valiosas. Todas as contribuições devem ser:
    • Bem escrito e bem testado
    • Discutido e aprovado pelos Mantenedores da área de código relevante. As discussões e aprovações acontecem nos problemas do GitHub e nos PRs do GitHub. Contribuições maiores requerem uma revisão de projeto .
    • Adicionado ao sistema de Integração Contínua do Bazel, se ainda não estiver presente.
    • Suportável e alinhado com a direção do produto Bazel
  • Revisão do código . Todas as alterações em todos os repositórios bazelbuild requerem revisão:
    • Todos os PRs devem 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 nos PRs no caso improvável de que a alteração exija modificações substanciais nos sistemas internos do Google.
  • Documentação . Quando relevante, as contribuições de recursos devem incluir atualizações de documentação.

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