Após estudarmos todos os aspectos referentes à arquitetura de software, vamos nos concentrar na sua documentação. Nosso foco será o que deve ser documentado, onde a UML se encaixa nesta documentação e como ela é usada para descrever a arquitetura de software.
A documentação da Arquitetura muitas vezes é uma questão que requer especial atenção em um projeto de TI. É comum que haja pouca ou nenhuma documentação referente à arquitetura em muitos projetos. Muitas vezes, quando existe alguma documentação, ela está desatualizada, é inadequada ou, basicamente, não é muito útil.
No outro extremo, há projetos que têm uma grande massa de informação de arquitetura capturada e documentada em diferentes documentos e ferramentas de design.
Diante deste cenário, fica claro que documentar arquitetura não é uma tarefa simples. Mas há boas razões para que façamos a documentação das nossas arquiteturas, por exemplo: