Política Editorial

Como uma ferramenta nasce

Toda ferramenta começa por uma pergunta concreta que alguém precisa responder, e não por um nome bonito. A conta é escrita separada da tela, para poder ser testada sozinha, e cada regra que importa vira um teste automático antes de a ferramenta ir ao ar.

Os testes cobrem os casos óbvios e, principalmente, as armadilhas: divisão que não fecha em centavos, taxa anual confundida com mensal, porcentagem somada de volta no lugar de dividida. São esses que produzem número plausível e errado, que é a pior categoria de erro.

Fontes e verificação

Quando um cálculo tem fórmula consagrada, usamos a fórmula e dizemos qual é. O IMC usa peso sobre altura ao quadrado; a taxa metabólica basal usa Mifflin-St Jeor; a parcela de financiamento usa a fórmula do sistema escolhido, Price ou SAC.

Os valores esperados dos testes são calculados ou conferidos em tabela de referência, nunca escritos de memória. Essa regra existe porque já falhamos nela: um valor plausível e errado dentro de um teste acusa defeito onde não há e esconde onde há.

O que fazemos quando não temos a informação

Dizemos que não temos. Nenhuma página do portal exibe nota de avaliação, número de avaliações, preço, disponibilidade, endereço, telefone ou data que não venha de fonte real.

Áreas que dependem de dados que ainda não temos ficam fora do ar até que tenhamos, mesmo com o código pronto. Preferimos uma lacuna assumida a um conteúdo preenchido com estimativa.

Os limites ficam na ferramenta

Cada ferramenta que faz uma simulação mostra, junto do resultado, o que aquela conta não cobre. A de custo por quilômetro diz que não inclui mão de obra nem pedágio; as de financiamento dizem que não são proposta de crédito e que o CET oficial do contrato pode ser maior.

Esses avisos ficam ao lado do número, e não no rodapé, porque é ao lado do número que eles mudam a decisão de quem lê.

Correções

Erro encontrado é erro corrigido, e com teste junto para não voltar. Boa parte das correções do portal saiu de alguém escrevendo para dizer que um número não parecia certo.

Se você encontrou um resultado errado, a página de reportar um problema é o caminho mais rápido.

Revisão e datas

A data de atualização de uma página só muda quando o conteúdo é de fato revisto. Data que anda sozinha a cada republicação é data inventada, e não usamos.