nordisk/dwarves

.nornir/_TEMPLATE-README.md

<!--
  GOLD README PATTERN (scaffolding template — routes to `other`, so `nornir docs book`
  omits it from the shipped manual; the copy you make becomes the real doc). This is the
  *source* — the repo-root README.md is GENERATED from `.nornir/README.md` by
  `nornir docs render` and carries a "⚠ GENERATED by nornir from .nornir/README.md — DO
  NOT EDIT this file" banner. Edit here, never the root copy. Keep it lean; depth lives in
  README-full.md.

  When you copy this template, put the class marker as the FIRST line of your new file:

      <!-- nornir:class: readme -->
-->

> Logo goes here (the gold pattern): a centered image at the top of the real README.
> Use a real, non-LFS raster or inline SVG under the assets dir — the docs→PDF (typst)
> reader loads the image via the git blob and HARD-FAILS the book on a missing/LFS asset,
> so this template carries no live image tag (a placeholder path would break the render).

# <Thing> <does the one memorable thing it does>

**<One-line pitch — what it is, in bold.>**

⚡ **<HALLMARK>** — <the standout capability · terse · metric-flavored>

- **<Bullet 1>**: <source-true claim>
- **<Bullet 2>**: <source-true claim>
- **<Bullet 3>**: <source-true claim>
- **<Bullet 4>**: <source-true claim>
- **<Bullet 5 (optional)>**: <source-true claim>

<!--
  Copy the two marker lines below (WITHOUT the fence) into the new repo's
  `.nornir/README.md`. They are FENCED here on purpose: `nornir docs render` fills
  every marker it finds in a `.nornir/*.md` source, and markers inside a code fence
  are ignored (`sections::parse_markers`). Unfenced, this template filled itself with
  DWARVES' own measured bench table — a real number sitting in a blank template that
  the next repo would copy verbatim and publish as its own.

  Pick the renderer by what you actually bench: `mashup` only when the run contains
  RIVAL systems (`holger_…` vs `nexus_…`); for a repo that benches only itself use
  `benches winner=row`, because mashup derives its system token from the leading
  `_`-delimited name segment and silently folds `<repo>.foo_cold` / `<repo>.foo_warm`
  into one row.
-->

```text
<!-- nornir:gen:start:benches winner=row -->
<!-- nornir:gen:end:benches -->
```

<sub>Honest method note: <how the numbers were measured / fair-hardware caveat>. Full method + every
metric: [`README-full`](.nornir/README-full.md).</sub>

---

Docs: [design](.nornir/<thing>-design.md) · [guide](.nornir/<thing>-guide.md) · [for idiots](.nornir/<thing>-for-idiots.md)