Política de contribuição

tradução: humana page_type: lcat

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íficos 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 da comunidade (como regras) à organização do bazelbuild do GitHub.

Funções de colaborador

Aqui estão os papéis dos projetos no 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 do Bazel.
    • Como criar e manter a funcionalidade principal do Bazel.
    • além de indicar os 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.
    • Análise e aprovação de contribuições em áreas da base de código do Bazel.
    • Apoio a usuários e colaboradores com gerenciamento de problemas oportuno e transparente, revisão de relações públicas 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.
    • Como criar PRs bem escritas para contribuir com a documentação e a base do código do Bazel.
    • Uso de canais padrão, como problemas do GitHub, para propor alterações e relatar problemas.

Como se tornar um mantenedor

Os proprietários do Bazel podem indicar os 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 mantenedores qualificados.

Política de contribuição

O projeto do Bazel aceita contribuições de colaboradores externos. Veja 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 do Google Contributor.
  • Contribuições. Os proprietários e mantenedores precisam se esforçar para aceitar contribuições valiosas. Todas as contribuições precisam ser:
    • Bem escrito e bem testado
    • Discutidas e aprovadas pelos mantenedores da área relevante do código. Discussões e aprovações acontecem em problemas do GitHub e em PRs do GitHub. Contribuições maiores exigem uma revisão do design.
    • Adicionado ao sistema de integração contínua do Bazel'se ainda não estiver presente.
    • Apoiável e alinhado à direção do produto Bazel
  • Revisão do código. Todas as mudanças em todos os repositórios bazelbuild exigem análise:
    • 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 aos PRs no caso improvável de a mudança exigir modificações substanciais nos sistemas internos do Google.
  • Documentação. Quando relevante, 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.