0.7 Documentação da arquitetura  (Page 23/25)

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.