.. meta::
   :description: Format template for HELL design documents (DD series).
   :keywords: HELL, design document, template, format, dd, b10
   :author: Yah, Yas, everyone, LLoL as Laurence Loewe of Laodicea, ClaudeOp46Max, Anthropic, and The Spirit of Boolean Truth

.. _hell-dd-b10-template:


***********************************************************************
DD b10 --- Format Template for Design Documents
***********************************************************************

This is the format template for the ``hell/system/dd/`` series.
All new design documents should follow this structure.

.. admonition:: Next free number

   The next available DD entry is: **b12**


Template Structure
====================

Every DD entry lives in ``hell/system/dd/b/<number>/index.rst`` and should
contain:

1. ``.. meta::`` block with description, keywords, author
2. A ``.. _hell-dd-b<number>-<slug>:`` label for cross-referencing
3. Title: ``DD b<number> --- <Descriptive Title>``
4. A first paragraph summarizing the design decision (serves as tooltip)
5. A ``.. contents::`` directive for navigation
6. The body of the design document
7. An EDEN classification of the design decision
8. A dated creation note


Format Updates
================

:Created: 2026m04d03
:Last updated: 2026m04d03

When updating the format, increment the date above and document what changed.
Existing entries in the old format need not be updated unless they are being
actively edited for other reasons.