Praticamos os conceitos apresentados neste capítulo no Apêndiceonde ilustramos o documento de arquitetura do SASF.
Dificuldades da documentação
Apesar dos benefícios proporcionados pela documentação daarquitetura, documentá-la não é fácil. A dificuldade de documentar a arquiteturareside, principalmente, em três características que descrevemos a seguir:
- o documento reflete o tamanho da solução;
- o documento reflete a complexidade do design da solução;
- é custoso manter o documento consistente com o designatual ao longo do ciclo de vida do software.
O tamanho do documento
Projetos de grandes sistemas de software são os quemais se beneficiam com o design e com a documentação da arquitetura.Isto ocorre porque o design e a documentação proporcionam orientaçãona implementação dos requisitos de qualidade, ajuda no controleintelectual sobre a complexidade da solução e servem de ferramentaque promove a integridade conceitual entre os stakeholders.
No entanto, um grande sistema de software implicanuma grande solução de design, que deve conter muitas decisõesarquiteturais e que devem ser apresentadas a muitos stakeholders, que demandamvisões diferentes. A consequência disso é que a arquitetura de umgrande sistema deverá ser apresentada em um documento extenso.
Documentos muito extensos podem ser fonte de algunsproblemas durante o processo de desenvolvimento. Entre estes problemas,podemos citar que eles levam muito tempo para serem construídos eque, em geral, geram uma certa resistência para serem lidos ouatualizados durante o desenvolvimento. Se o documento não é lido ou nãoé atualizado durante o desenvolvimento (e isso pode ocorrer porque a arquiteturapode evoluir ao longo do tempo, seja a evolução planejada ou não),ele corre o risco de ficar inconsistente com a realidade do software, tornando-seuma fonte de informação inútil e, portanto, deixando de proporcionaras vantagens de se projetar e documentar a arquitetura.
A complexidade do documento
Tanto o tamanho do documento quanto a complexidadedo design influenciam na complexidade do documento da arquitetura. Umdocumento muito complexo, que usa muitas visões e diferentes linguagenspara descrever diferentes aspectos do software, é difícil de se construire de se manter consistente em caso de mudanças durante a evoluçãoda arquitetura.