Design Docs

May be stale

This page was last updated ago, on 1 September 2026. Check what it says against the code before relying on it.

Plans and proposals, kept apart from the technical topics because they describe work rather than document behaviour. A design doc argues for a change — what it would touch, in what order, and what it deliberately leaves alone. For how the gamemode actually works today, use the topics list instead.

Open each doc with front matter; the table below is built from it, so a doc that omits a field leaves a hole in the index rather than going unlisted:

---
title: Docs layout migration          # sidebar and index label; falls back to the first heading
status: Proposed                      # Proposed / Accepted / Landed / Implemented / Abandoned
date: 2026-08-22                      # when it was written, not when it landed
description: One line on what it changes.
pinned: true                          # optional; lifts it to the top of this list
---

A body of work large enough to need several docs gets its own folder below, with one of them marked index: true to serve as its landing page.

Sections