Skip to Content
Communication Patterns
book

Communication Patterns

by Jacqui Read
October 2023
Intermediate to advanced
306 pages
7h 53m
English
O'Reilly Media, Inc.
Content preview from Communication Patterns

Appendix A. ADR Templates

Use these templates to structure your architecture decision records (ADRs). They are also available on the companion website.

ADR Structure

See “ADR Structure” for instructions on how to use each section. See Figures 12-3, 12-4, and 12-5 for examples of how to use this template.

Identifier and Title: A Statement of the Decision Made

Status

Draft/Decided/Superseded by ADR-XXX

Context

Why you need to make the decision. Assumptions, constraints, and decision drivers.

Evaluation Criteria

What is important to you in making this decision? Which of your architectural characteristics apply to making this decision? Should any constraints or decision drivers become a criterion?

Options

Outlines of the options considered against the evaluation criteria (usually using a score or rating), and trade-offs outside of the evaluation criteria. See “ADR Options” for a template.

Decision

The choice that was made and why.

Implications

The positive and negative consequences of the decision made.

Consultation

If taking input from others, document it here. Although consultation takes place before a decision is made, it is documented at the end because it can become long and obscure the decision itself.

ADR Options

Use the ADR Options table (Table A-1) in the Options section of your ADR. For an example of how this table can be used, see Figures 12-3 and 12-4. To use Table A-1:

  • Create one table per option considered.

  • Add a row for each of your evaluation ...

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

More than 5,000 organizations count on O’Reilly

AirBnbBlueOriginElectronic ArtsHomeDepotNasdaqRakutenTata Consultancy Services

QuotationMarkO’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.
Julian F.
Head of Cybersecurity
QuotationMarkI wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.
Addison B.
Field Engineer
QuotationMarkI’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.
Amir M.
Data Platform Tech Lead
QuotationMarkI'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.
Mark W.
Embedded Software Engineer

You might also like

Resonate: Present Visual Stories that Transform Audiences

Resonate: Present Visual Stories that Transform Audiences

Nancy Duarte
Storytelling with You

Storytelling with You

Cole Nussbaumer Knaflic
Storytelling with You

Storytelling with You

Cole Nussbaumer Knaflic

Publisher Resources

ISBN: 9781098140533Errata Page