• Post Reply Bookmark Topic Watch Topic
  • New Topic
programming forums Java Mobile Certification Databases Caching Books Engineering Micro Controllers OS Languages Paradigms IDEs Build Tools Frameworks Application Servers Open Source This Site Careers Other Pie Elite all forums
this forum made possible by our volunteer staff, including ...
  • Campbell Ritchie
  • Devaka Cooray
  • Ron McLeod
  • Paul Clapham
  • Liutauras Vilda
  • paul wheaton
  • Jeanne Boyarsky
  • Tim Cooke
Saloon Keepers:
  • Stephan van Hulst
  • Tim Holloway
  • Tim Moores
  • Mikalai Zaikin
  • Carey Brown

Documenting Software Architectures: Views and Beyond (2nd Edition)

Posts: 962
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
Author/s    : Paul Clements, Felix Bachmann, Len Bass, David Garlan, James Ivers, Reed Little, Paulo Merson, Paulo Merson, Robert Nord, Judith Stafford
Publisher   : Addison Wesley
Category   : Design Patterns, UML, and Refactoring, Project Management, Process and Best Practices
Review by : Wouter Oet
Rating        : 7 horseshoes

This book tries to provide a guidance on how to make your architecture understandable through documentation.

The book is very complete, all the information you would expect to find is in it. But I feel that the authors took it too far. The amount of information can be overwhelming especially because it is spread over large pieces of text. The book can be hard to read because the language is very technical and the writing style isn't very entertaining. Luckily, the authors included a readers guide (advising you on which chapters to read depending on your background).

The content of the book is good. It contains lots of quotes, sideline hints/tips and perspectives which are very useful. Also the usage of diagrams and examples make it much more understandable. The summaries, questions and references at the end of each chapter are a great addition.

"Documenting Software Architectures" is very complete which makes it ideal as a reference book. It is not for the faint-hearted/beginners but is an addition to each architects bookshelf.

Disclosure: I received a copy of this book from the publisher in exchange for writing this review on behalf of CodeRanch.

More info at Amazon.com
rubbery bacon. rubbery tiny ad:
a bit of art, as a gift, that will fit in a stocking
    Bookmark Topic Watch Topic
  • New Topic