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.
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.