Development¶

This section is a deliberate concession outside the strict four-quadrant Diátaxis model — it houses the repo's raw decision history and any developer guides that don't fit Tutorials, How-To Guides, Reference, or Explanation. If you're looking for how to use a component, start at Reference instead; this section is about working on this repo.

Specs¶

Every non-trivial decision behind a component is a dated spec, written before any implementation. Specs covers the process — how to write one, the status lifecycle, and the naming convention — and is also the entry point into the archive of 30+ specs shipped so far. The Explanation section curates the most significant decisions into readable prose; the decision log is a one-page, at-a-glance summary table of all of them. This section is the raw source material both draw from.

Developer guides¶

Beyond specs, this is where a standalone developer guide would live — how the self-test harness works internally, the release pipeline's wiring, and similar repo-internal material that's useful to a contributor but isn't a per-component reference or a task-oriented how-to. None exist yet as separate pages; the day-to-day authoring workflow (writing a component, its self-test, its docs, cutting a release) is currently covered by Contributing. Add a guide here when one earns its own page.