SVO — software verification & operations

O relatório mostra onde olhar.

Cada apontamento traz o nome do arquivo, a linha, e os passos que levam de fora do sistema até o problema. O seu time abre o relatório ao lado do código, segue o caminho escrito e comprova o problema no próprio ambiente — com o caminho na mão desde a primeira linha.

É isso que separa um apontamento de um aviso: o aviso diz que existe algo errado; o apontamento diz onde, como se chega lá, e o que observar quando você chegar.

Ver uma amostra de relatório →

Os campos, sempre os mesmos

É o que torna o relatório conferível pelo seu time sem depender de nós.

arquivo e linha
Onde está, com a linha exata — e as simétricas, quando o mesmo padrão se repete.
rastro
A cadeia percorrida da entrada até a linha que produz o efeito.
evidência
O trecho literal do código, conferido linha a linha contra o próprio código.
impacto
O que acontece na prática, e para quem.
correção
O caminho da correção — não o código pronto. Quem corrige é você.
como verificar
O teste objetivo que prova que acabou.
esforço e responsável
Tamanho da correção e quem no time deveria tratá-la.

A falha é apontada

A falha é apontada e documentada.

O caminho está escrito, e a confirmação no sistema rodando fica com o seu time, que é quem pode fazê-la com segurança.

O que o relatório ensina

O relatório é lido uma vez para corrigir, e consultado depois para escrever código novo. Os campos são sempre os mesmos justamente para isso: ele serve de referência quando a próxima funcionalidade tocar no mesmo caminho.

Os dois formatos

O HTML é para apresentar. O Markdown é para trabalhar.

O relatório é entregue nos dois, sempre.