Política de contribuição

tradução: humano 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 bazelbuild do GitHub.

Funções de colaborador

Veja abaixo uma descrição dos papéis no projeto do Bazel, incluindo as responsabilidades deles:

  • Owners: 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.
    • 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.
    • Analisar e aprovar contribuições em áreas da base de código do Bazel.
    • Apoiar usuários e colaboradores com gerenciamento oportuno e transparente de problemas, revisão de relações públicas e documentação.
    • Liberar, 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 registro de contribuições anteriores 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 do Bazel aceita contribuições de colaboradores externos. Estas são 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 o máximo possível para aceitar contribuições de valor. Todas as contribuições precisam:
    • Bem escrito e bem testado
    • Discutidos e aprovados 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.
    • Suporte e alinhado com a direção do produto Bazel
  • Revisão de código. Todas as mudanças em todos os repositórios bazelbuild precisam de revisão:
    • Todos os PRs devem ser aprovados por um proprietário ou mantenedor.
    • Apenas proprietários e mantenedores podem mesclar PRs.
  • Compatibilidade. Os proprietários talvez precisem rejeitar ou solicitar modificações nos PRs no caso improvável de a mudança exigir modificações significativas nos sistemas internos do Google.
  • Documentação. Quando relevante, as contribuições de recursos precisam incluir atualizações da documentação.

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