Design decisions · The decision · Element
The scope
Where the decision applies.
The part
What it is
One screen, a pattern used everywhere, or a general principle. The scope determines what a change to it affects.
Pattern-level decisions are the ones worth recording most carefully, since changing one affects everything using it.
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.