decision
Decision
One decision with the options that were on the table. Bold the chosen option, italicize the rejected ones, and add `— why` after each. Paragraphs after the list describe what happens next. For a feature grid, use Compare.
- use it
- Good for an ADR or a tradeoff: what you picked, what you didn't, and why.
database
Bold is chosen, italic is rejected, the rest stay open. `— why` sits next to each. Paragraphs after the list say what follows.
acceptedMar 12
- Postgresboring, and we already run it
- Mongono joins we trust
- SQLitefine until the second writer
Revisit if writes pass 2k a second.
<Decision title="DATABASE" status="accepted" date="Mar 12">
- **Postgres** — boring, and we already run it
- *Mongo* — no joins we trust
- SQLite — fine until the second writer
Revisit if writes pass 2k a second.
</Decision>install
command
rendering
- Glyphs in a framecopy the source, no chart runtime
- SVGdoes not survive a README
- Canvasno text to select or search
- Mermaidfine for flows, wrong for numbers
Every figure has a fenced twin for GitHub.
<Decision title="CHARTS">
- **Glyphs in a frame** — copy the source, no chart runtime
- *SVG* — does not survive a README
- *Canvas* — no text to select or search
- Mermaid — fine for flows, wrong for numbers
Every figure has a fenced twin for GitHub.
</Decision>| Prop | Type | Default | Description |
|---|---|---|---|
| title | string | "decision" | Caption drawn on the top edge of the frame. |
| status | string | — | proposed, accepted, superseded. First row, left. |
| date | string | — | Muted, first row, right. |
| children | Markdown | — | A list of options, then paragraphs. Bold is chosen, italic is rejected. |
| options | { label, reason?, state? }[] | — | Data form. state is chosen, open, or rejected. |
| palette | "mono" | "duo" | "multi" | "mono" | mono is one accent plus muted. duo paints the second series with --graph-accent-2. multi cycles three accents. |
| corner | string | "+" | Character at each corner of the frame. |
| frame | "box" | "corners" | "rule" | "none" | "box" | box draws the dashed border. corners keeps only the corner marks. rule draws dashed lines above and below. none drops the border and padding, and puts the title above the content. |
| className | string | — | Passed to the outer frame. |