Na documentação, fornecemos uma lista de regras recomendadas.
Este é um conjunto de regras de alta qualidade que proporcionará uma boa experiência aos nossos usuários. Diferenciamos as regras suportadas e as centenas de que você encontra na Internet.
Indicação
Se um conjunto de regras atender aos requisitos abaixo, um administrador de regras poderá indicá-lo para fazer parte das regras recomendadas ao preencher uma Problema no GitHub.
Após uma análise pela equipe principal do Bazel, recomendadas no site do Bazel.
Requisitos para os mantenedores de regras
- O conjunto de regras tem um recurso importante, útil para muitos comandos usuários (por exemplo, suporte a uma linguagem amplamente conhecida).
- O conjunto de regras está bem mantido. É preciso ter pelo menos dois mantenedores ativos.
- O conjunto de regras é bem documentado, com exemplos e fácil de usar.
- O conjunto de regras segue as práticas recomendadas e é eficiente (consulte guia de desempenho).
- O conjunto de regras tem cobertura de teste suficiente.
- O conjunto de regras é testado BuildKite com a versão mais recente do Bazel. Os testes devem sempre passar (quando usados como um verificação de pré-envio).
- O conjunto de regras também é testado com as próximas alterações incompatíveis. Falhas deve ser corrigido em duas semanas. Os problemas de migração devem ser informados ao a equipe do Bazel rapidamente.
Requisitos para desenvolvedores do Bazel
- As regras recomendadas são frequentemente testadas com o Bazel no início (pelo menos uma vez dia).
- Nenhuma alteração no Bazel pode violar uma regra recomendada (com o conjunto padrão de ). Se isso acontecer, a alteração deverá ser corrigida ou revertida.
Rebaixamento
Se houver a preocupação de que um determinado conjunto de regras não esteja mais atendendo ao requisitos, um problema no GitHub deve ser registrada.
Os mantenedores das regras serão contatados e precisarão responder em duas semanas. Com base no a equipe principal do Bazel talvez decida rebaixar o conjunto de regras.