Nesta página, descrevemos como os colaboradores podem propor e fazer mudanças no Bazel. base de código.
- Leia a política de contribuição do Bazel.
- Crie um problema no GitHub para discutir o plano e o design. Solicitações de envio que mudam ou adicionam comportamentos um problema correspondente para rastreamento.
- Se você estiver propondo alterações significativas, escreva um documento de design.
- Verifique se você assinou uma Licença de Colaborador do Google.
- Prepare uma confirmação git que implemente o recurso. Não se esqueça de adicionar testes e atualizar a documentação. Se a mudança tiver efeitos visíveis ao usuário, adicionar notas da versão. Se for uma alteração incompatível, leia o guia para implementar alterações interruptivas.
- Criar uma solicitação de envio em GitHub. Se você é novo no GitHub, ler sobre atração solicitações. Observe que restringimos as permissões para criar ramificações no repositório principal do Bazel. você vai precisar enviar seu compromisso para sua própria bifurcação repositório.
- Um administrador do Bazel deve designar um revisor para você em até dois dias úteis (exceto feriados nos EUA e na Alemanha). Se você não receber um revisor nesse período, solicite um por e-mail bazel-discuss@googlegroups.com (link em inglês).
- Trabalhe com o revisor para concluir uma revisão de código. Para cada mudança, crie uma um novo commit e enviá-lo por push para fazer alterações em sua solicitação de envio. Se a análise levar muito tempo (por exemplo, se o avaliador não responder), envie um e-mail para bazel-discuss@googlegroups.com (link em inglês).
Quando a revisão é concluída, um administrador do Bazel aplica o patch ao Sistema interno de controle de versões do Google.
Isso aciona as verificações internas de pré-envio. que podem sugerir mais mudanças. Se você não tiver expressado sua preferência, o o administrador que envia sua alteração adiciona "trivial" alterações (como linting) que não afetam do projeto. Se forem necessárias alterações mais profundas ou se você preferir aplicar as alterações diretamente, você e o revisor devem comunicar as preferências claramente nos comentários das avaliações.
Após o envio interno, o patch é exportado como uma confirmação do Git, Nesse momento, a solicitação de envio do GitHub é encerrada. Todas as alterações finais são atribuídas a você.