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, o administrador da regra poderá indicar que ele fará parte das regras recomendadas enviando um problema do 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).
- A regra é bem mantida. É preciso ter pelo menos dois mantenedores ativos.
- O conjunto de regras é bem documentado, com exemplos e fácil de usar.
- A regra segue as práticas recomendadas e tem bom desempenho (consulte o guia de performance).
- 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 equipe do Bazel rapidamente.
Requisitos para desenvolvedores do Bazel
- As regras recomendadas são testadas com frequência com o Bazel na cabeça (pelo menos uma vez por 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 aos 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.