Política de contribuição

Translation: human page_type: lcat

Informar um problema Acessar código-fonte

Nesta página, abordamos o modelo de governança e a política de contribuição do 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 na organização bazelbuild) são liderados, mantidos e gerenciados por membros da comunidade. A equipe do Google Bazel analisa as sugestões para adicionar repositórios de propriedade da comunidade (como regras) à organização bazelbuild do GitHub.

Funções de colaborador

Confira abaixo as descrições dos papéis no projeto do Bazel, incluindo as responsabilidades dele:

  • Proprietários: equipe do Google Bazel. Os proprietários são responsáveis por:
    • Estratégia, manutenção e liderança do projeto Bazel.
    • Criar e manter a funcionalidade principal do Bazel.
    • Indicar mantenedores e aprovar novos repositórios.
  • mantenedores: a equipe do Google Bazel e os usuários designados do GitHub. Os mantenedores são responsáveis por:
    • Criar e manter a funcionalidade principal do repositório.
    • Revisar e aprovar contribuições para áreas da base de código do Bazel.
    • oferecer suporte a usuários e colaboradores com gerenciamento de problemas oportuno e transparente, revisão de RP e documentação;
    • Liberar, testar e colaborar com 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 registro de contribuições anteriores consistentes e responsáveis que planejam grandes contribuições no futuro podem ser considerados como mantenedores qualificados.

Política de contribuição

O projeto 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 se esforçar ao máximo para aceitar contribuições valiosas. Todas as contribuições precisam 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 exigem uma análise de design.
    • Adicionado ao sistema de integração contínua do Bazel, se ainda não estiver presente.
    • Suportável e alinhado à direção do produto Bazel
  • Revisão de código. Todas as mudanças em todos os repositórios bazelbuild exigem revisão:
    • Todos os PRs devem ser aprovados por um Proprietário ou Mantém.
    • Somente proprietários e mantenedores podem mesclar PRs.
  • Compatibilidade. Os proprietários podem precisar rejeitar ou solicitar modificações aos PRs no caso improvável de a mudança exigir modificações substanciais nos sistemas internos do Google.
  • Documentação. Quando relevantes, as contribuições de recursos precisam incluir atualizações da documentação.

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