volume_mute

When is Detailed Architectural Documentation Justified?

publish date: 2026/06/10 09:23:15.604066 UTC

volume_mute

In most projects, block diagrams are the only architectural documentation that exists. When is it justified to invest in a more detailed, formal architectural description? Select ALL that apply.

When developing critical systems where a detailed dependability analysis of the system is needed

When it is necessary to convince external regulators that the system conforms to regulations

When using model-driven development approaches

For every software project regardless of size or criticality

Whenever the development team has more than five members

Correct Answer

(1) When developing critical systems where a detailed dependability analysis of the system is needed

(2) When it is necessary to convince external regulators that the system conforms to regulations

(3) When using model-driven development approaches

Explanation

Detailed architectural documentation is not worth the cost for most systems. Exceptions include: developing critical systems requiring dependability analysis; situations where external regulators must be convinced of conformance; and model-driven development where the model is used to generate code. Block diagrams remain appropriate for communication during the design process in most other cases.

Reference

Software Engineering, Ian Sommerville, 10th edition

Quizzes you can take where this question appears

Architectural Views