Equipe editorial
Uma pessoa escreve os guias. Outra lê o conteúdo financeiro de cada guia antes de ser publicado. Esta página diz quem são, o que a revisão verifica e o que você mesmo pode conferir.
Autor
Kostan Proff
Trabalha com infraestrutura de TI — nuvem, CI/CD, infraestrutura como código — onde uma mudança que não pode ser verificada não é implementada. Manter ambientes de nuvem enxutos e pipelines de entrega rápidos é o trabalho diário; o mesmo padrão é aplicado neste site. A aritmética reside em um só lugar, as fórmulas são cobertas por testes unitários que as verificam em relação a números de empréstimos publicados, e cada número que vem de fora traz sua fonte e a data em que foi lido. Escreve os guias e mantém o motor de cálculo.
Revisor financeiro
Tetiana Goncharko
Lê o conteúdo financeiro de um guia antes de ser publicado: os números, as premissas por trás deles e as fontes de onde vêm. O autor constrói o motor de cálculo; o revisor lê o resultado do outro lado, o lado de alguém que lida com dinheiro em vez de código. Seu nome aparece apenas nos guias que revisou.
O que você pode conferir
A aritmética é pública
O código por trás de cada calculadora está em um repositório público, com as fórmulas que ele implementa, os testes unitários que as verificam em relação a números publicados conhecidos e as verificações que bloqueiam uma versão com uma página quebrada. Você não precisa aceitar os números com base na confiança, e não precisa perguntar.
Dois nomes, duas funções
Um nome escreve os guias e mantém o motor de cálculo. Outro lê o conteúdo financeiro de um guia antes de ser publicado, verificando os números, as premissas por trás deles e as fontes de onde vêm. As duas funções são separadas propositalmente: a pessoa que escreve um guia não é a pessoa que faz a leitura final.
Onde um guia nomeia um revisor, essa é a pessoa que o revisou, e o nome aparece apenas naquele guia e em nenhum outro lugar. Uma revisão é uma declaração sobre uma página específica, portanto, ela está vinculada à página e não ao site como um todo.
Todo o restante nesta página descreve o que a revisão verifica e o que você pode verificar sem perguntar a ninguém.
O que a revisão verifica
Antes de um guia ser publicado, o revisor segue a mesma lista todas as vezes:
- A aritmética. Cada fórmula é conferida com a fonte de onde vem, e o exemplo prático no texto é recalculado do zero. Onde um número aparece no código, ambos são comparados.
- As unidades. Porcentagens contra decimais, meses contra anos, dólares contra milhares. A maioria dos erros em um documento financeiro é um erro de unidade.
- Os casos extremos. Uma taxa zero, um prazo zero, um valor negativo. Cada um é verificado para produzir uma resposta sensata em vez de uma mensagem de erro.
- A redação. A página não deve dizer o que você deve fazer. Ela explica o que um número significa e do que ele depende, e para por aí. Um guia que recomenda uma ação é reescrito.
- As fontes. Cada link é aberto, verificado quanto à afirmação à qual está vinculado e datado.
Como as ferramentas de redação são usadas
As ferramentas de redação auxiliam no texto. Elas não decidem o que uma página diz. Cada número, cada fórmula e cada afirmação é escrita ou verificada por uma pessoa, e nenhuma página é publicada sem a revisão acima. Uma ferramenta que produz um número plausível é exatamente o tipo de coisa que este processo existe para detectar.
A verificação que detecta isso não é apenas humana. O motor de cálculo possui testes unitários que são executados a cada alteração e bloqueiam uma liberação se um número mudar: o cronograma deve somar o valor emprestado, o empréstimo deve ser encerrado exatamente em zero e a projeção período a período deve concordar com a fórmula de forma fechada em todas as frequências de capitalização. Um trecho de texto não pode falhar dessa maneira. Uma fórmula pode, e quando isso acontece, a compilação é interrompida.
Datas de revisão
Cada guia traz a data em que foi revisada pela última vez. Um guia cujo conteúdo depende de dados externos é revisado pelo menos duas vezes por ano; um guia que explica aritmética é revisado quando a fórmula por trás dele muda e, em qualquer caso, uma vez por ano. Quando uma página é revisada, a data muda, independentemente de o texto ter sido alterado ou não, portanto, a data informa quando uma pessoa leu a página pela última vez.
Correções
As correções são feitas de forma transparente. Uma página que foi corrigida mantém sua data de revisão atualizada e a correção é descrita no tópico de contato de onde veio. Um guia com um número incorreto é uma falha na revisão, não na redação, e o processo de revisão é o que muda.