Software Architect's Handbook

Design rationale for design documentation

The software architecture must be documented, and the design rationale is an important part of that documentation. If the documentation only shows the design, those looking at it will know what was designed but won't know why it was designed that way. They also won't be aware of the alternatives that were considered, and why those alternatives were rejected.