Skip to content

view on a desktop screen for a better experience.

decision

Decision

One decision and the options next to it. Bold is chosen, italic is rejected, `— why` after each. Paragraphs after the list say what follows. A feature grid is Compare.

database

Bold is chosen, italic is rejected, the rest stay open. `— why` sits next to each. Paragraphs after the list say what follows.

[ DATABASE ]
acceptedMar 12
  • Postgresboring, and we already run it
  • Mongono joins we trust
  • SQLitefine until the second writer

Revisit if writes pass 2k a second.

Chose Postgres over 2 other options.

MDX

<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

[ CHARTS ]
  • 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.

Chose Glyphs in a frame over 3 other options.

MDX

<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>
[ PROPS ]
PropTypeDefaultDescription
titlestring"decision"Caption drawn on the top edge of the frame.
statusstring—proposed, accepted, superseded. First row, left.
datestring—Muted, first row, right.
childrenMarkdown—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.
cornerstring"+"Character at each corner of the frame.
classNamestring—Passed to the outer frame.