Documentação

Achados e execuções

Onde ficam os achados das verificações, onde cada execução é registrada e como lê-los entre projetos.

O que as verificações encontram fica vinculado ao trabalho ao qual pertence, e cada execução é registrada em um único log. Cada um tem seu lugar:

  • Os achados de uma tarefa. Eles são listados na seção de Qualidade da tarefa na Factory, indicando o status de cada um: ainda aberto, em processo de correção, corrigido ou aceito.
  • Falhas de teste que não pertencem a nenhuma tarefa. Um teste de navegador agendado que falhou, por exemplo, fica na Factory sob Revisão. Corrija-o para transformá-lo em uma tarefa ou aceite-o com um motivo.
  • Verificações que não podem ser executadas. Quando um projeto não possui estrutura de testes unitários, por exemplo, a linha Testes unitários em Controle de Qualidade informa isso, e sua correção gera uma tarefa para configurá-la.
  • Execuções. Cada execução, com sua duração e custo, é listada nas Configurações sob Atividade.

Padrões entre os trabalhos.

Um achado em uma tarefa é um detalhe. O mesmo achado em trinta tarefas constitui um padrão, e são nos padrões que estão as decisões úteis.

O que observar:

  • Achados que se repetem. O mesmo problema em muitas tarefas representa ou uma dívida técnica que merece um trabalho dedicado, ou uma verificação que não está alinhada às suas convenções.
  • Achados que ninguém resolve. Uma categoria constantemente aceita indica que a verificação não justifica seu espaço.
  • Concentração. Um projeto que gera a maioria dos achados revela onde focar a atenção.

Execuções

A Atividade lista todas as execuções da organização: agentes, tarefas, verificações de qualidade e testes. Filtre por resultado, tipo, projeto e período, e abra uma execução para ver suas verificações, resultados e saída.

O padrão útil aqui é a repetição de falhas na mesma etapa em tarefas não relacionadas — trata-se de um problema de configuração do projeto, não de código, e reexecutar as tarefas não resolverá o problema. Consulte Configuração de build e teste.

Transformando padrões em trabalho.

Um achado repetido pode se tornar uma tarefa. Esse é o objetivo de identificá-lo: "esse padrão aparece em quarenta arquivos" é um trabalho a ser feito, não uma condição permanente no código-fonte.

Quando uma condição deve ser monitorada continuamente em vez de verificada manualmente, uma automação pode vigiar essa situação e abrir um trabalho de remediação.

Ajustar em vez de tolerar.

Se os achados forem excessivos, as verificações estão mal calibradas, não o seu código é excepcionalmente ruim.

Uma verificação que dispara na maioria das alterações descreve seu código-fonte, não identifica problemas. Ou a regra não corresponde às suas convenções, ou descreve uma dívida que você optou por manter. Em ambos os casos, a verificação precisa ser alterada — consulte Políticas e portas de qualidade.