Wouldn’t it be interesting if Leadership Decision Records (LDRs) were a thing?

(The equivalent of ADRs for software architecture)

#Leadership #SoftwareArchitecture

Follow

@JonTheNiceGuy @nick_tune my team uses Miro boards and "post its as decision" instead of textual records due to the reduced friction and the capability to visually organize decisions into application layers, or different viewpoints such as testing or observability. Less space to write in, but finding and moving content more quickly?

@giorgiosironi @JonTheNiceGuy @nick_tune How do you then keep track of the context that led to that decision? Context, alternatives, etc? Are those recorded on surrounding post its?

Good question @noctovis !
The templates I use all have "context" as one of the headings. The rest of the template is as follows:

```
# {0000}. {TITLE}
Date: {yyyy-mm-dd}
## Status
{Accepted|Proposed} by {author}
{Superceded by 0000}

## Context
{Given external factor A and B, a choice was made between options 1 or 2}

## Decision
{Option X was selected because REASON}

## Consequences
{Because X was selected project Z can now proceed. Project Y cannot.}
```
/ @giorgiosironi @nick_tune

@noctovis
D'oh just realised you wanted to know what @giorgiosironi was doing, not what the rest of us are/were. Please ignore my previous!

@nick_tune

@JonTheNiceGuy @giorgiosironi @nick_tune No worries, it’s interesting to see which templates are being used because there are many different ones!

@noctovis @JonTheNiceGuy @nick_tune we have tended not to record the "why" as much as the "what". Sometimes there is a link to an example from the code, which provides context along with the position in the map e.g. what architectural layer we are in.
Our motivation was speeding up repeatable decision-making while we build new features, more than architecture auditing or evolution: that might be why. Assuming if we change decisions later on the context has changed enough that it needs to be evaluated again.

Sign in to participate in the conversation
Qoto Mastodon

QOTO: Question Others to Teach Ourselves
An inclusive, Academic Freedom, instance
All cultures welcome.
Hate speech and harassment strictly forbidden.