how-i-build

Sobre

Por que isto existe

Isto começou como um problema com duas respostas ruins.

A maior parte do que eu construo vive em repositórios privados — parte porque não é meu para abrir, parte porque abrir entrega a própria coisa. Um repositório fechado não prova nada para quem está de fora. Abrir tudo resolve a prova e destrói o ativo.

O que é público aqui

As decisões, não o código.

O registro de um projeto é o que eu esbarrei, o que escolhi, o que aquilo custou e o que eu faria diferente. Isso sobrevive sem o fonte, e é a parte que é realmente difícil. O repositório pode continuar fechado e o raciocínio ainda pode ser lido.

Por que tem cara de caderno

Porque é um. Entradas curtas, honestas sobre trade-offs, com changelog quando algo muda de verdade. Não é site de tutorial nem wiki — esses prometem completude, e completude é promessa que ninguém cumpre.

O primeiro projeto documentado aqui é este site, que é o único lugar honesto de começar: se eu vou afirmar que registrar decisões vale o esforço, o site que faz a afirmação deveria ser o primeiro a fazê-lo.

Dois idiomas

Inglês é o padrão porque é onde estão os leitores. Português existe porque é meu. Todo case e todo post existe nos dois — garantido pelo build, não por disciplina.