tags:

views:

62

answers:

1
+2  Q: 

Recommended architecture artifacts

For those who document their architectures, what sort of artifacts to you produce and recommend?

I've been using the 4+1 Architectural View model for my last couple of projects, and I think it is quite a good approach. But I'm keen to hear if there are alternatives, and if there is an accepted "best practice" in this area. And especially if there is an archtiectural artifact that fits nicely with Scrum.

+1  A: 

4+1 works as well as anything. I've been using it and am reasonably happy.

Customers demand documentation. Their QA folks are happy with 4+1. I'm happy with 4+1 views.

Approximately no one has ever read a single word. How do I know? No questions after delivery.

S.Lott  2010-01-03 22:13:45
Yes, I'm beginning to think that while architecture is essential, architectural doco is highly optional...
CraigS  2010-01-03 22:23:45
Really, the most valuable thing is the simplified overview picture in a powerpoint presentation. That's what project managers, product owners, users, etc., can point to and articulate. Everything else is details.
S.Lott  2010-01-03 23:39:49

related questions

What is the best architecture to bridge to XMPP?
How to expose a collection property?
How do you build a ratings implementation?
Alternative "architectural" approaches to javaScript client code?
Split data access class into reader and writer or combine them?
Guide to choosing between REST vs SOAP services?
Best architecture for handling file system changes?
Globalization architecture
How Did You Decide Between WISA and LAMP?
Best Blogs for Software Architecture
Experience documentation about Shared Nothing Architecture
Agile architectures
VS.NET Application Diagrams
Documenting program architecture
Books for software architect
How do you do system integration?
Design debate: what are good ways to store and manipulate versioned objects?
Passing more parameters in C function pointers
Send messages to program through command line
Interfaces on different logic layers
How to structure a java application, in other words: where do I put my classes?
Are there any negative reasons to use an N-Tier solution?
Linux - files and scripts that execute on boot
Good STL-like library for C.
Best way to allow plugins for a PHP application