A importância da documentação arquitetural é frequentemente subestimada. Muitos argumentam que não veem necessidade de produzi-la, mas, se analisarmos bem, muitas vezes já fazemos isso sem nos dar conta.
Quantas vezes você esboçou um diagrama em um quadro branco para ajudar um novo membro da equipe a compreender o funcionamento do sistema? E quantas vezes você se pegou tirando uma foto desse quadro ou pedindo que ninguém o apagasse? Esse ato é uma forma de documentação arquitetural. A questão principal é que, muitas vezes, não damos a devida importância em armazená-la de maneira correta e estruturada. Como resultado, repetimos o esforço toda vez que uma nova pessoa se junta à equipe.
É crucial diferenciar entre a falta de disciplina em manter a documentação arquitetural e a suposta falta de necessidade de produzi-la. Pense nisso: há uma grande diferença entre os dois.
Você já refletiu sobre quantas horas de trabalho poderiam ser economizadas com uma documentação arquitetural bem feita?
Documentação arquitetural precisa ser produzida de maneira profissional e correta. E esse é um papel vital dos arquitetos.
Refletir sobre nossas práticas e melhorá-las é o que nos torna profissionais cada vez melhores. Pense nisso.
