Build an ASR Workbook
Once you’ve identified requirements with architectural significance, record them in an ASR Workbook. At the beginning of a new software system, the ASR Workbook is a living document and changes rapidly. As the architecture coalesces, you’ll edit the workbook less frequently but reference it more often. Executable tests and source could eventually supplant portions of the ASR Workbook as a source of truth, though the document will remain an important historical record.
The ASR Workbook provides context and information for programmers, testers, and of course, architects. The more people who understand the ASRs, the less architectural oversight will be required.
Here is a sample ASR Workbook outline. Use the outline as a checklist ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access