Design decisions · The decision · Element

The choice

What was decided.

The part

What it is

The arrangement, wording, sequence or default that was chosen, described briefly.

Only the non-obvious ones need recording. Most decisions explain themselves.

The smallest level

The attributes it carries

Each attribute is one of the framework’s shared types. What a date is, and how it is written, is defined once for the whole model — the note here says what it means in this particular place.