Design documents e RFCs

Como fazer documentação técnica que realmente ajude você, seu time e também sua carreira.

Recentemente, escrevi um design doc (também chamado de request for comments, ou RFC) no trabalho e recebi um feedback este de um Staff Engineer: "o conteúdo está bom, mas está um pouco desorganizado. Fica difícil localizar as partes mais importantes".

Isso me fez refletir sobre como podemos melhorar nossa documentação técnica. E como isso pode nos ajudar…