A primeira rede social sobre arquitetura de software do Brasil

Iniciar pela documentação é uma boa forma de introduzir arquitetura de software?

Olá pessoal,
no "livro amarelo" (Software Architecture in Practice) Len Bass coloca uma questão interessante. Ele conta que em um treinamento de arquitetura de software o cliente sugeriu iniciar pela documentação ao invés de ver inicialmente todos os conceitos de arquitetura de software. A documentação agiria como um veículo de treinamento para os colaboradores.

A justificativa foi que como eles teriam de fazer a documentação, de um jeito ou de outro, durante o processo de preenchimento do documento eles teriam de documentar diferentes pontos de vista (visualizações), eles teriam de discutir sobre como o artefato iria satisfazer metas de qualidade. Enfim, eles poderiam aprender sobre conceitos de arquitetura no processo de documentação.

O autor diz que esta forma de utilização de documentação como um veículo de formação foi uma novidade para ele, mas tem um grande poder. Para profissionais submersos na "lama técnica", pensar em questões de arquitetura é um grande salto. Compreender a mentalidade envolvida em arquitetura de software, através de documentação pareceu ser uma boa ferramenta de ensino sem uma grande sobrecarga inicial.

O que vocês acham? Iniciar pela documentação é uma boa forma de introduzir arquitetura de software?

▶ Responder esta

Respostas a este tópico

Permalink Responder até Eros Viggiano em 30 outubro 2009 at 15:24: Sim, é uma forma interessante para iniciar na arquitetura de software pois introduz o raciocínio arquitetural sistêmico, principalmente pelo fato de remeter a um pouco de concretude em uma disciplina tão abstrata.; ▶ Responder esta

Permalink Responder até Ricardo Ferreira em 3 novembro 2009 at 15:51: É uma abordagem interessante, sem dúvida alguma.

Mas acrescentaria o ponto que, essa ação fosse feita com o cuidado de dar uma visão deste documento (ou a abordagem em si) para todos os envolvidos, incluindo o cliente final. Se somente o pessoal técnico usá-lo pra sair um pouco da "Lama Tećnica" e exercitar conceitos e práticas de arquitetura de software, acredito que o resultado não será tão satisfatório.

A arquitetura de software deve ser unipresente em todas as disciplinas de software, especificamente falando, ter ciência absoluta de todas as pessoas que participam de um projeto. Assim, foco, prazo e custo serão muito melhor trabalhados, tendo em mente a abordagem arquitetural.

Outro forte motivador pra isso, é que se isso for um trabalho "somente de técnicos", não vejo com bons olhos (me colocando no lugar dos patrocinadores) investir tempo e dinheiro para que um bando de geeks (perdão da expressão, eu sou um também) fiquem brincando de arquitetos. Todos os envolvidos precisam enxergar o valor intrínsico da abordagem, para ai sim, dar crédito e investimento ao mesmo.; ▶ Responder esta

Permalink Responder até Camilo Ribeiro em 13 janeiro 2010 at 19:12: De acordo com o Ricardo,

Quanto mais cedo os envolvidos no projeto puderem ver a arquitetura "viva" na documentação, mais rápido eles poderão avaliar o quanto a arquitetura está de acordo com os requisitos não funcionais.

Para a visão de teste por exemplo, quanto mais cedo temos a arquitetura documentada, mais cedo podemos planejar e priorizar os testes não funcionais, inclusive quanto a qualificação e alocação de recursos e aquisição de treinamentos e ferramentas.

Quando temos acesso a documentação da arquitetura, "forçamos" os arquitetos a explicar a Arquitetura orientada aos requisitos não funcionais, facilitando a identificação de defeitos e estimulando a visualização outras alternativas para solucionar o mesmo problema.; ▶ Responder esta