Uma verificação é uma única verificação. Uma execução é uma execução das verificações em uma política contra uma alteração. Uma achado é algo que uma verificação relatou.
Encontre-os em Qualidade → Execuções e Qualidade → Achados.
Lendo uma execução
Uma execução exibe cada verificação, seu resultado e sua saída. Quando uma tarefa falha na verificação, a execução é onde você descobre o motivo.
Leia-a de cima para baixo. A primeira verificação com falha geralmente é a real — falhas posteriores costumam ser consequências. Uma falha de compilação seguida por doze falhas de teste representa um problema, não treze.
Achados
Os achados vêm de agentes revisores, scanners e portas de orientação. Cada um traz o que foi encontrado, onde e qual sua gravidade.
Seu ciclo de vida:
- Gerado por uma verificação ou por um revisor.
- Encaminhado — achados corrigíveis são devolvidos ao agente desenvolvedor como retrabalho; os demais são anexados ao pull request.
- Resolvido — corrigido, aceito ou suprimido.
Triagem
A pergunta para cada achado não é "isso é verdade?" mas sim "isso muda o que acontecerá a seguir?"
- Corrigir agora — correção, segurança ou qualquer coisa que causaria reprovação na revisão.
- Aceitar — verdadeiro, mas não vale a pena agir agora. Registre o motivo.
- Suprimir — falso positivo ou regra que não se aplica a esse código.
Suprima deliberadamente e com um motivo. Uma supressão sem explicação é indistinguível de alguém silenciando uma verdade inconveniente, e seis meses depois ninguém saberá qual dos dois foi.
Quando há muitos achados
O volume é um sinal sobre a configuração, não sobre a qualidade do código.
Uma verificação que dispara na maioria das alterações não está encontrando problemas — está descrevendo sua base de código. Ou a regra não corresponde às suas convenções, ou descreve uma dívida técnica que você decidiu tolerar. Ambos significam que a verificação tem o formato errado.
Achados e portas
Um achado de uma porta de orientação é informação. O mesmo achado de uma porta bloqueante interrompe a tarefa. O achado é idêntico; a política decide seu custo.
Essa é a alavanca a ser usada quando uma verificação está correta, mas é muito agressiva: altere sua severidade em vez de removê-la. Veja Políticas e portas de qualidade.