37 lines
1.7 KiB
Markdown
37 lines
1.7 KiB
Markdown
# Annotation Callout (italic-serif aside)
|
|
|
|
Use for editorial asides — the "italic pointer" that marks a detail without competing with the primary diagram grammar. Think marginalia: *"structure IS the index"*, *"no imports, no configuration"*.
|
|
|
|
## Grammar
|
|
|
|
```svg
|
|
<!-- 1. Italic Instrument Serif text -->
|
|
<text x="904" y="36" fill="#0b0d0b" font-size="14" font-style="italic"
|
|
font-family="'Instrument Serif', serif" text-anchor="end">no imports, no configuration</text>
|
|
<!-- 2. Dashed Bézier leader -->
|
|
<path d="M 820 44 Q 700 84 520 216" fill="none"
|
|
stroke="rgba(11,13,11,0.40)" stroke-width="1" stroke-dasharray="4,3"/>
|
|
<!-- 3. Landing dot -->
|
|
<circle cx="520" cy="216" r="2" fill="#0b0d0b"/>
|
|
```
|
|
|
|
## Rules
|
|
- Italic + serif together signal "editorial voice" against the diagram's sans/mono body. Don't substitute italic sans or italic mono — the combination is load-bearing.
|
|
- Dashed path (`stroke-dasharray="4,3"`) distinguishes the callout leader from primary arrows (which are solid).
|
|
- Place callouts in margins (top-right, bottom-left). Never inside the active diagram area.
|
|
- Max 2 callouts per diagram. More becomes commentary, not signal.
|
|
|
|
## Colors
|
|
|
|
| Intent | Text | Leader |
|
|
|---|---|---|
|
|
| Neutral aside | ink `#0b0d0b` | `rgba(11,13,11,0.40)` |
|
|
| Focal / accent | coral `#f7591f` | `rgba(247,89,31,0.50)` |
|
|
| Tertiary (muted) | muted `#52534e` | `rgba(11,13,11,0.30)` |
|
|
|
|
## Anti-patterns
|
|
- Solid arrow leader (reads as a flow arrow).
|
|
- Italic sans or italic mono — the serif is load-bearing.
|
|
- Callouts crossing primary arrows / lifelines — offset to a clear margin.
|
|
- Using a callout to label something the diagram should label directly — put the label on the element.
|