Design decisions · The decision · Element
The alternatives
What else was considered.
The part
What it is
Especially the obvious alternative, since that is what a later designer will propose.
Recording it saves the same discussion being had again with the same conclusion.
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.