Pular para o conteúdo
Bruno Alexandre Tecnologia, infraestrutura e desenvolvimento

Sistema que ninguém documenta é sistema que só o autor entende

Documentação feita depois, com o sistema funcionando, é mais barata do que refatoração de código sem contexto.

Bruno Alexandre 11/10/2026 4 leituras
Documentação escrita no fim do projeto, com o sistema já funcionando, é bem mais barata do que a alternativa de descobrir, dois anos depois, o que cada parte do sistema faz.

E o que precisa ser documentado não é o código. É o porquê das decisões: por que aquela biblioteca, por que aquele banco, por que a regra de negócio está naquele lugar e não em outro. O código muda; o motivo da escolha continua válido e é o que permite corrigir depois.

Quando a documentação é feita junto, ela sai quase de graça. Quando é feita no final, vira um projeto, e projeto adiado é documento que nunca existe.

Leia também