Design decisions · The rationale · Element

The location

Where the rationale lives.

The part

What it is

In the design system next to the pattern, rather than in a document. A rationale a designer has to know about does not reach them.

A comment in the component itself is frequently the most effective place.

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.