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.
A falha é apontada
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 relatório é entregue nos dois, sempre.