Замечание по документированию архитектуры от SEI CMU

В догонку к посту о стандарте описания архитектуры IEEE 1471/ISO 42010.

Институт программной инженерии Университета Карнеги-Меллон (SEI CMU - тот самый, который разработал CMM/CMMI, TSP - Team Software Process и еще много всяких полезностей) опубликовал т.н. "технические замечания" (technical note, dec'09) к обсуждаемому стандарту:

• A Structured Approach for Reviewing Architecture Documentation

Сам материал, кстати, очень классно позиционирует проблематику описания архитектуры:

This technical note proposes a structured approach for reviewing architecture documentation (AD) Given the critical importance of architecture to software project success, it follows that the architecture cannot be effective unless it is effectively captured in documentation that allows the architecture's stakeholders to understand and use the architecture in the way it was intended. That is, the documentation of the architecture inherits the criticality of the architecture itself. An architecture that cannot be understood (or, worse, is misunderstood) because of deficient docu-mentation will fail to meet its goals as surely as a poorly chosen architecture.

Put succinctly, if your architecture is not well described, it doesn't matter if it's well designed.

Если вы действительно архитектор (пусть не по должности. но по своей роли), настоятельно рекомендую уделить внимание этому материалу.

Вы ещё не документируете архитектуру? тогда мы идём к вам! задумайтесь, а может всё-таки это стОит того?

>> оригинальный пост -Замечание по документированию архитектуры от SEI CMU