Blog

QMD: documentação que você não consulta é um cemitério

Você tem 400 arquivos markdown e nunca acha o certo. Buscar pela palavra exata acha a palavra, não a ideia. O que transforma esse monte de docs numa base consultável.

Nem todo documento de repositório pertence ao Markdown

O plano do seu time está todo no .md, e o VP ainda não consegue lê-lo até uma decisão. Markdown é ótimo como formato de fonte, não como formato de leitura.

Pega uma mudança simples feita por IA e segue ela até produção. O que decide se vira produto ou incidente não é o modelo, é o que está em volta dele. Com exemplo.