Documentare le architetture software: Viste e oltre

Recensioni dei lettori

Il libro è molto apprezzato per il suo approccio completo alla documentazione dell'architettura software, che offre spiegazioni chiare, consigli pratici e una struttura che aiuta gli architetti a trasmettere i loro progetti. Sottolinea l'importanza della documentazione nell'architettura del software ed è adatto a un'ampia gamma di interlocutori, tra cui architetti, analisti aziendali e studenti. Tuttavia, alcuni recensori hanno notato dei limiti in alcune aree e hanno suggerito che il libro potrebbe non soddisfare pienamente le esigenze di coloro che cercano una guida molto specifica.

⬤ Consigli completi e ben strutturati sulla documentazione dell'architettura del software.
⬤ Miglioramenti nella seconda edizione, comprese le risorse online.
⬤ Rilevante per vari tipi di pubblico, dagli architetti del software agli analisti aziendali.
⬤ Incoraggia l'applicazione pratica dei concetti con esempi chiari.
⬤ Raccomandazioni elevate da parte di diversi professionisti che ne indicano l'importanza nel settore.

⬤ Alcune aree mancano di una guida approfondita, in particolare per quanto riguarda le intersezioni con i requisiti e le specifiche di progettazione.
⬤ Alcune parti del contenuto possono sembrare ripetitive per alcuni lettori.
⬤ Sono stati segnalati casi in cui il libro non fornisce esempi completi di lavoro.
⬤ Alcuni lettori lo hanno trovato solo moderatamente utile o hanno ritenuto che non rispondesse pienamente alle loro aspettative.

(basato su 35 recensioni dei lettori)

Titolo originale:

Documenting Software Architectures: Views and Beyond

Contenuto del libro:

“Questa nuova edizione è più luminosa, più brillante, più completa, più pragmatica e più mirata della precedente, e non avrei pensato che fosse possibile migliorare l'originale. Poiché il campo dell'architettura del software è cresciuto negli ultimi decenni, c'è molto di più da dire, molto di più da sapere e molto di più da riflettere su ciò che ha funzionato e su ciò che non ha funzionato... e gli autori qui fanno tutto questo e molto di più.” --Dalla prefazione di Grady Booch, IBM Fellow.

L'architettura del software - il collante concettuale che tiene insieme tutte le fasi di un progetto per le sue numerose parti interessate - è ampiamente riconosciuta come un elemento critico nello sviluppo del software moderno. Gli addetti ai lavori hanno scoperto sempre più spesso che l'attenzione all'architettura di un sistema software dà buoni frutti. Senza un'architettura appropriata al problema da risolvere, un progetto si incaglierà o, molto probabilmente, fallirà. Anche con un'architettura eccellente, se questa non è ben compresa o ben comunicata, è improbabile che il progetto abbia successo.

Documenting Software Architectures, Second Edition, fornisce la guida più completa e attuale, indipendentemente dal linguaggio o dalla notazione, su come catturare un'architettura in una forma comunemente comprensibile. Attingendo alla loro vasta esperienza, gli autori aiutano innanzitutto a decidere quali informazioni documentare e poi, con linee guida ed esempi (in varie notazioni, tra cui UML), mostrano come esprimere un'architettura in modo che altri possano costruire, usare e mantenere con successo un sistema a partire da essa. Il libro presenta le regole per una buona documentazione, gli obiettivi e le strategie della documentazione, le viste e gli stili architettonici, la documentazione per le interfacce e il comportamento del software e i modelli per catturare e organizzare le informazioni per generare un pacchetto coerente. Novità e miglioramenti in questa seconda edizione:

⬤ Copertura di stili architetturali come le architetture orientate ai servizi, le architetture multi-tier e i modelli di dati.

⬤ Guida alla documentazione in un ambiente di sviluppo Agile.

⬤ Trattamento più approfondito della documentazione della logica, che riflette le migliori pratiche industriali.

⬤ Modelli migliorati, che riflettono anni di utilizzo e feedback, e più opzioni di layout per la documentazione.

⬤ Un nuovo esempio completo (disponibile online), con la documentazione di un sistema orientato ai servizi basato sul Web.

⬤ Guide di riferimento per tre importanti linguaggi di documentazione dell'architettura: UML, AADL e SySML.