Documentar a arquitetura

Uma arquitectura de software é uma entidade complexa que não pode ser descrita de uma forma unidimensional simples.

Uma vista é uma representação de um conjunto de elementos e relações entre eles não todos os elementos do sistema, mas aqueles de um determinado tipo.

Uma visão em camadas de um sistema mostraria elementos do tipo "camada"; ou seja, mostraria a decomposição do sistema em camadas, juntamente com as relações entre essas camadas. Uma visão em camadas pura não mostraria, contudo, os serviços do sistema, ou clientes e servidores, ou modelo de dados, ou qualquer outro tipo de elemento.

As vistas permitem nos dividir a entidade multidimensional (a arquitectura do software) em várias representações parciais e inteligíveis do sistema.

Documentar uma arquitectura é uma questão de documentar as vistas relevantes e depois acrescentar documentação que se aplica a mais do que uma visão.