From 4b987c8a55b361a11b0d8959bd4f83b258bdfce5 Mon Sep 17 00:00:00 2001
From: Valerii Korobeinikov <transitrix@users.noreply.github.com>
Date: Fri, 7 Aug 2026 23:59:23 +0400
Subject: [PATCH] site: add a page for the .ttrs document source format, plus
 robots.txt and sitemap.xml

The document source format had no public explanation at a stable address. This
adds one at /ttrs/ (and /de/ttrs/): what a source file contains, how the
filename's middle segment names the document kind rather than a notation, the
directive language with the committed conformance fragment, the reference
states an implementation must keep distinct, and the two render profiles. It
links the normative specification, the reference implementation and the
conformance fixture.

llms.txt stated that every source file carries the YAML suffix. It now states
both canonical extensions, that which one a notation takes is a property of
that notation, and links the new page.

sitemap.xml lists all fourteen published pages with their language alternates;
robots.txt references it. Neither file existed.
---
 de/dsl-examples/index.html |   1 +
 de/index.html              |   2 +-
 de/ttrs/index.html         | 200 +++++++++++++++++++++++++++++++++++++
 dsl-examples/index.html    |   1 +
 index.html                 |   2 +-
 llms.txt                   |   5 +-
 robots.txt                 |   8 ++
 sitemap.xml                |  77 ++++++++++++++
 ttrs/index.html            | 200 +++++++++++++++++++++++++++++++++++++
 9 files changed, 493 insertions(+), 3 deletions(-)
 create mode 100644 de/ttrs/index.html
 create mode 100644 robots.txt
 create mode 100644 sitemap.xml
 create mode 100644 ttrs/index.html

diff --git a/de/dsl-examples/index.html b/de/dsl-examples/index.html
index 38594d6..633ff72 100644
--- a/de/dsl-examples/index.html
+++ b/de/dsl-examples/index.html
@@ -486,6 +486,7 @@ <h2 id="next-heading">Weiterführend</h2>
       <ul>
         <li>Vollständige Methodikspezifikation: <a href="https://github.com/transitrix/methodology">github.com/transitrix/methodology</a></li>
         <li>Jede Notationsspezifikation: <a href="https://github.com/transitrix/methodology/tree/main/notations">Notationen auf GitHub</a></li>
+        <li>Dokumentquellen, die andere Dateistruktur: <a href="/de/ttrs/">Das Dokumentquellformat <code>.ttrs</code></a></li>
         <li>JSON Schemas: <a href="https://github.com/transitrix/transitrix-studio/tree/main/schemas">Schemas auf GitHub</a></li>
         <li>Maschinenlesbare Projektübersicht: <a href="/llms.txt">llms.txt</a></li>
         <li>Studio installieren, um alles oben live in der Vorschau zu sehen: <a href="/install/">Installieren &amp; starten →</a></li>
diff --git a/de/index.html b/de/index.html
index a9b2fda..8738375 100644
--- a/de/index.html
+++ b/de/index.html
@@ -144,7 +144,7 @@ <h2 id="layers-heading">Ein Modell, jede Ebene</h2>
 
     <section aria-labelledby="open-heading">
       <h2 id="open-heading">Was heute offen ist</h2>
-      <p>Sowohl die Methodik als auch Transitrix Studio sind öffentlich. Die Methodikspezifikation liegt unter <a href="https://github.com/transitrix/methodology">github.com/transitrix/methodology</a>. Transitrix Studio — eine Editor-Erweiterung und CLI — lässt sich in VS Code, Cursor, VSCodium, Windsurf und IntelliJ IDEA installieren; siehe die <a href="install/">Installationsoptionen</a>. Quellcode unter <a href="https://github.com/transitrix/transitrix-studio">github.com/transitrix/transitrix-studio</a>. Die genaue Struktur jeder Notation zeigen die <a href="dsl-examples/">DSL-Beispiele</a>.</p>
+      <p>Sowohl die Methodik als auch Transitrix Studio sind öffentlich. Die Methodikspezifikation liegt unter <a href="https://github.com/transitrix/methodology">github.com/transitrix/methodology</a>. Transitrix Studio — eine Editor-Erweiterung und CLI — lässt sich in VS Code, Cursor, VSCodium, Windsurf und IntelliJ IDEA installieren; siehe die <a href="install/">Installationsoptionen</a>. Quellcode unter <a href="https://github.com/transitrix/transitrix-studio">github.com/transitrix/transitrix-studio</a>. Die genaue Struktur jeder Notation zeigen die <a href="dsl-examples/">DSL-Beispiele</a>; Dokumentquellen — Fließtext mit Direktiven, benannt <code>*.&lt;kind&gt;.ttrs</code> — beschreibt die Seite <a href="ttrs/">Das Dokumentquellformat <code>.ttrs</code></a>.</p>
       <p>Wenn Sie Transitrix für einen Piloten prüfen oder die Arbeit verfolgen möchten, schreiben Sie an <a href="mailto:hello@transitrix.com">hello@transitrix.com</a>.</p>
       <div class="note">
         <strong>Releases verfolgen</strong> — via Atom/RSS abonnieren: <a href="https://github.com/transitrix/transitrix-studio/releases.atom">Transitrix Studio</a> · <a href="https://github.com/transitrix/methodology/releases.atom">Methodik</a>. URL in einen RSS/Atom-Reader eintragen oder auf GitHub Watch → Releases wählen.
diff --git a/de/ttrs/index.html b/de/ttrs/index.html
new file mode 100644
index 0000000..75f5e4e
--- /dev/null
+++ b/de/ttrs/index.html
@@ -0,0 +1,200 @@
+<!DOCTYPE html>
+<html lang="de">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Das Dokumentquellformat .ttrs | Transitrix</title>
+  <meta name="description" content="Das Dokumentquellformat .ttrs: was eine Quelldatei enthält, wie die mittlere Komponente des Dateinamens die Dokumentart benennt, die Direktivensprache und die Referenzzustände, die eine Implementierung unterscheiden muss.">
+  <link rel="canonical" href="/de/ttrs/">
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:ital,wght@0,400;0,600;1,400&family=IBM+Plex+Mono:wght@400&display=swap" rel="stylesheet">
+  <link rel="stylesheet" href="../../assets/css/style.css">
+  <link rel="icon" type="image/png" sizes="128x128" href="/assets/img/favicon-128.png">
+  <link rel="apple-touch-icon" sizes="256x256" href="/assets/img/apple-touch-icon.png">
+  <link rel="alternate" hreflang="en" href="../../ttrs/">
+  <link rel="alternate" hreflang="de" href="./">
+  <script>if(localStorage.getItem('theme')==='light')document.documentElement.setAttribute('data-theme','light');</script>
+  <!-- Cloudflare Web Analytics -->
+  <script defer src="https://static.cloudflareinsights.com/beacon.min.js" data-cf-beacon='{"token": "1d2971bbe7964ede92ee02e5c78da48c"}'></script>
+  <!-- End Cloudflare Web Analytics -->
+</head>
+<body>
+  <a class="skip-link" href="#main">Zum Inhalt springen</a>
+  <header class="site-header">
+    <div class="wrap">
+      <a class="logo" href="../../">Transitrix</a>
+      <div class="header-right">
+        <button class="theme-toggle" id="theme-toggle" aria-label="Thema wechseln">
+          <svg class="icon-moon" width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"/></svg>
+          <svg class="icon-sun" width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="5"/><line x1="12" y1="1" x2="12" y2="3"/><line x1="12" y1="21" x2="12" y2="23"/><line x1="4.22" y1="4.22" x2="5.64" y2="5.64"/><line x1="18.36" y1="18.36" x2="19.78" y2="19.78"/><line x1="1" y1="12" x2="3" y2="12"/><line x1="21" y1="12" x2="23" y2="12"/><line x1="4.22" y1="19.78" x2="5.64" y2="18.36"/><line x1="18.36" y1="5.64" x2="19.78" y2="4.22"/></svg>
+        </button>
+        <nav class="lang-switch" aria-label="Sprache">
+          <a href="../../ttrs/" hreflang="en">EN</a>
+          <a href="./" aria-current="true">DE</a>
+        </nav>
+      </div>
+    </div>
+  </header>
+  <main id="main" class="wrap">
+    <div class="hero">
+      <h1>Das Dokumentquellformat <code>.ttrs</code></h1>
+      <p class="lede">Eine Dokumentquelle ist Fließtext mit <code>{{ … }}</code>-Direktiven darin. Der Text wird unverändert übernommen; jede Direktive benennt etwas in einem Transitrix-Modell und wird durch das ersetzt, wozu sie aufgelöst wird.</p>
+    </div>
+
+    <section aria-labelledby="jump-heading">
+      <h2 id="jump-heading">Auf dieser Seite</h2>
+      <ul class="qs-viewers">
+        <li><a href="#file">Was eine Quelldatei enthält</a> · <a href="#filename">Wie der Dateiname gelesen wird</a></li>
+        <li><a href="#language">Die Direktivensprache</a> · <a href="#fragment">Ein durchgearbeitetes Beispiel</a></li>
+        <li><a href="#states">Referenzzustände</a> · <a href="#profiles">Render-Profile</a></li>
+        <li><a href="#today">Was heute existiert</a></li>
+      </ul>
+    </section>
+
+    <section aria-labelledby="file">
+      <h2 id="file">Was eine Quelldatei enthält</h2>
+      <p>Eine Textdatei, zweiteilig: ein YAML-Kopf, danach der Dokumentkörper.</p>
+      <p>Der Körper ist gewöhnlicher Fließtext. Alles außerhalb von <code>{{ … }}</code> ist fester Text und wird wortgetreu übernommen; jedes <code>{{ … }}</code> ist eine Direktive, die etwas im Modell benennt und durch das ersetzt wird, wozu sie aufgelöst wird.</p>
+      <div class="code-wrapper">
+        <button class="copy-btn" data-copy-label="Kopieren" data-copied-label="Kopiert ✓" aria-label="Kopfbeispiel in die Zwischenablage kopieren">Kopieren</button>
+        <pre><code>---
+document: Market Requirements Document   # erforderlich — der Name, den seine Leser verwenden
+kind: mrd                                # erforderlich — passt zur mittleren Komponente des Dateinamens
+template_id: product.mrd                 # erforderlich — im Laufprotokoll benannt
+template_version: "1.0"                  # erforderlich — im Laufprotokoll benannt
+canon: ../canon                          # optional — das Modell-Repository
+---</code></pre>
+      </div>
+      <p>Vier Kopffelder sind erforderlich; <code>canon:</code> ist es nicht. Eine Quelle, die kein Modellobjekt und keine abgeleitete Abbildung benennt, löst eigenständig auf, ganz ohne konfiguriertes Repository — das ist eine legitime Eingabe für sich, und eine Implementierung, die eine solche Quelle liest, meldet den Zustand „kein Repository konfiguriert“, statt ihn als fehlgeschlagene Auflösung zu behandeln.</p>
+    </section>
+
+    <section aria-labelledby="filename">
+      <h2 id="filename">Wie der Dateiname gelesen wird</h2>
+      <div class="code-wrapper">
+        <pre><code>&lt;basename&gt;.&lt;kind&gt;.ttrs        z. B.  product.mrd.ttrs
+                                     platform.srs.ttrs
+                                     gateway.sdd.ttrs</code></pre>
+      </div>
+      <p><strong>Die mittlere Komponente ist die <em>Dokumentart</em> — niemals eine Notation.</strong> Eine Art ist ein Layout über dem Modell: welche Elemente ein Dokument dieser Art auswählt und wie sie angeordnet werden. Sie trägt keinen eigenen Inhalt, erhält keine eigene Direktivensprache, und eine neue Art bedeutet nie eine neue Sprache. Die heute spezifizierten Arten sind <code>mrd</code>, <code>srs</code>, <code>sdd</code> und <code>sds</code>; das Kopffeld <code>kind:</code> muss mit dem Dateinamen übereinstimmen.</p>
+      <p>Jede Notation hat genau eine kanonische Dateiendung, und zwar entweder <code>*.&lt;short-name&gt;.transitrix.yaml</code> oder <code>*.&lt;short-name&gt;.ttrs</code>. Welche davon eine bestimmte Notation trägt, ist eine Eigenschaft dieser Notation. Wo <code>.ttrs</code> gilt, ersetzt es die längere Endung vollständig — es wird ihr nie angehängt, und keine Notation trägt beide.</p>
+      <p><code>.trs</code> liegt einen Tastendruck daneben und ist ein anderes, weit verbreitetes Format. Eine Datei mit der Endung <code>.trs</code> dort, wo eine Dokumentquelle erwartet wird, wird als eben diese Verwechslung benannt und nicht als unbekannte Datei gemeldet.</p>
+    </section>
+
+    <section aria-labelledby="language">
+      <h2 id="language">Die Direktivensprache</h2>
+      <p>Die Begrenzer sind <code>{{</code> und <code>}}</code>. Leerraum unmittelbar innerhalb der Begrenzer ist unerheblich, <code>{{REQ-14}}</code> und <code>{{ REQ-14 }}</code> sind also dieselbe Direktive. <code>\{{</code> erzeugt ein wörtliches <code>{{</code> und ist die einzige Maskierung der Sprache. Keine Direktive verschachtelt sich in eine andere, abgesehen davon, dass die beiden Blockformen unten einen Körper tragen.</p>
+
+      <h3>Inline-Formen</h3>
+      <ul>
+        <li><code>{{ REQ-14 }}</code> — <strong>Inline-Referenz.</strong> Setzt den Anzeigewert des benannten Objekts ein.</li>
+        <li><code>{{ REQ-14.parent.title }}</code> — <strong>Feldpfad.</strong> Setzt ein Feld ein und läuft dabei durch jede mittlere Komponente, die selbst ein Objekt benennt. <strong>Die Traversierung ist auf Tiefe 3 begrenzt</strong>; ein längerer Pfad ist ein Fehler und kein tieferer Lauf.</li>
+        <li><code>{{ .field }}</code> — <strong>Zeilenreferenz.</strong> Ein Feld der aktuellen Zeile des umgebenden <code>each</code>-Blocks, und nur innerhalb eines solchen sinnvoll.</li>
+        <li><code>{{ trace from = … to = … via = … }}</code> — <strong>Trace.</strong> Stellt die Trace-Abdeckung zwischen zwei Elementtypen entlang einer Beziehung dar; alle drei Attribute sind erforderlich.</li>
+        <li><code>{{ view &lt;pfad&gt; [as = …] [fit = width|page|none] }}</code> — <strong>abgeleitete Abbildung.</strong> Eine in einer bestehenden Notation verfasste Sicht, aus dem Modell gerendert. <code>fit</code> ist standardmäßig <code>width</code>.</li>
+        <li><code>{{ figure &lt;pfad&gt; [caption = "…"] [as = …] }}</code> — <strong>beigestellte Abbildung.</strong> Ein Asset, das unverändert eingebettet und nie erzeugt wird.</li>
+        <li><code>{{ figref &lt;name&gt; }}</code> — <strong>Abbildungsverweis</strong> über den <code>as</code>-Namen einer zuvor im selben Dokument deklarierten Abbildung. Abbildungen werden in Dokumentreihenfolge nummeriert, und ein Vorwärtsverweis ist ein Fehler und keine aufgeschobene Auflösung.</li>
+      </ul>
+
+      <h3>Blockformen — es gibt genau zwei</h3>
+      <p><code>{{# each &lt;TYP&gt; [where …] [order by &lt;feld&gt;] }} … {{/ each }}</code> wiederholt seinen Körper einmal je ausgewähltem Element und bindet jedes davon der Reihe nach als aktuelle Zeile. Die <code>where</code>-Klausel ist bewusst klein gehalten: nur <code>and</code>, kein <code>or</code> und keine Klammern; nur <code>=</code> und <code>!=</code>; rechts steht ein Literal, nie ein weiteres Feld. <code>order by</code> nimmt ein einzelnes Feld und ist das, was ein gerendertes Dokument reproduzierbar macht.</p>
+      <p><code>{{# instruct &lt;slot-id&gt; }} … {{/ instruct }}</code> deklariert einen Anweisungsslot — einen Abschnitt, den ein deterministischer Durchlauf nicht füllt, mit <code>question:</code> und <code>sufficient:</code> (beide erforderlich) und einem optionalen, kommagetrennten <code>inputs:</code>. <strong>Der Körper eines Slots ist opak:</strong> Ein Parser läuft vom öffnenden Tag direkt zum passenden schließenden und behält alles dazwischen als Rohtext, sodass ein innerhalb eines Slots geschriebenes <code>{{ REQ-14 }}</code> Anweisungstext ist und nie aufgelöst wird. Slot-Bezeichner bestehen aus Kleinbuchstaben, Ziffern und Bindestrichen und müssen innerhalb eines Dokuments eindeutig sein.</p>
+
+      <h3>Bezeichner</h3>
+      <p>Ein Bezeichner folgt der kanonischen Grammatik — <code>REQ-14</code>, <code>CAP-1</code>, <code>BUSINESS_SERVICE-3</code>. Ein Fähigkeitsbezeichner enthält eine Diagrammadresse, deren Punkte zum Bezeichner gehören; ein Parser trennt daher das Präfix <code>CAPABILITY-V</code> bzw. <code>CAPABILITY-H</code> ab, bevor er einen Feldpfad liest: <code>{{ CAPABILITY-V1.2.3 }}</code> ist ein Bezeichner ohne Feldpfad, <code>{{ CAPABILITY-V1.2.3.name }}</code> derselbe Bezeichner mit dem Feldpfad <code>name</code>.</p>
+    </section>
+
+    <section aria-labelledby="fragment">
+      <h2 id="fragment">Ein durchgearbeitetes Beispiel</h2>
+      <p>Das eingecheckte Konformitätsbeispiel, vollständig — ein Kopf, fester Text, eine Referenz, ein Feldpfad, ein zweistufiger Pfad, eine abgeleitete Abbildung mit einem Verweis darauf und ein Anweisungsslot.</p>
+      <div class="code-wrapper">
+        <button class="copy-btn" data-copy-label="Kopieren" data-copied-label="Kopiert ✓" aria-label="Durchgearbeitetes Beispiel in die Zwischenablage kopieren">Kopieren</button>
+        <pre><code>---
+document: Market Requirements Document
+kind: mrd
+template_id: product.mrd
+template_version: "1.0"
+canon: canon
+---
+# {{ CAP-1.title }}
+
+## Scope
+
+This document covers {{ CAP-1.text }}
+
+## Requirements
+
+**{{ REQ-14 }}** — {{ REQ-14.text }}
+
+Its parent capability is {{ REQ-14.parent.name }}.
+
+{{ view diagrams/context.blocks.transitrix.yaml as = context fit = width }}
+
+{{ figref context }} shows where the capability sits.
+
+## Market
+
+{{# instruct market-size }}
+question: How large is the addressable market for this capability, and how fast is it growing?
+inputs: CAP-1, REQ-14
+sufficient: A market size with a currency and a year, a growth rate, and the method used to derive both.
+{{/ instruct }}</code></pre>
+      </div>
+      <p>Die Datei ist <a href="https://github.com/transitrix/methodology/blob/main/packages/document-renderer/tests/fixtures/product.mrd.ttrs">product.mrd.ttrs</a>, und die Ausgabe, die sie erzeugen muss, liegt daneben eingefroren als <a href="https://github.com/transitrix/methodology/blob/main/packages/document-renderer/tests/fixtures/product.mrd.expected.md">product.mrd.expected.md</a>.</p>
+    </section>
+
+    <section aria-labelledby="states">
+      <h2 id="states">Referenzzustände</h2>
+      <p>Die Auflösung einer Referenz ergibt genau einen Zustand. Neben <em>ok</em> — aufgelöst, zugelassen und innerhalb seines Gültigkeitsintervalls — benennt die Sprache fünf weitere, und <strong>eine Implementierung muss jeden Zustand, den sie meldet, von jedem anderen unterscheidbar halten.</strong></p>
+      <ul>
+        <li><strong>nicht aufgelöst</strong> <code>⚑U</code> — es existiert kein Objekt mit diesem Bezeichner.</li>
+        <li><strong>nicht zugelassen</strong> <code>⚑A</code> — das Objekt existiert, sein Zulassungsstatus ist aber nicht aktiv.</li>
+        <li><strong>außerhalb der Gültigkeit</strong> <code>⚑V</code> — sein Gültigkeitsintervall deckt das Renderdatum nicht ab.</li>
+        <li><strong>fraglich</strong> <code>⚑S</code> — das Objekt löst auf, die Verknüpfung dorthin steht aber unter Verdacht.</li>
+        <li><strong>kein Repository konfiguriert</strong> — das Dokument beruft sich auf das Modell, und es ist keines konfiguriert.</li>
+      </ul>
+      <p>Die ersten drei werden in dieser Reihenfolge bestimmt: Existenz, dann Zulassung, dann Gültigkeit. Zwei Zustände zu einem zusammenzuziehen ist Nichtkonformität und keine Vereinfachung — <em>Sie haben kein Repository</em> und <em>Ihr Repository kennt diesen Bezeichner nicht</em> sind verschiedene Probleme mit verschiedenen Behebungen, und jeder Zustand benennt für seinen Leser etwas anderes zu tun.</p>
+      <p><strong>Eine nicht-ok-Referenz wird nie als ihr blanker Wert dargestellt.</strong> Der Zustand, der sich wie korrekter Text liest, ist derjenige, den ein Leser nicht erkennen kann.</p>
+      <p><code>⚑S</code> wird aus der Commit-Historie abgeleitet statt aus einer Datei gelesen und ist der eine Zustand, dessen Berechnung eine Implementierung ablehnen darf. Ablehnen ist zulässig; darüber zu schweigen nicht — drei Ergebnisse müssen unterscheidbar bleiben: <em>fraglich</em>, <em>geprüft und sauber</em> und <em>nie geprüft</em>. Ein Dokument, das ganz ohne <code>⚑S</code> rendert, trifft eine Aussage; eine Implementierung, die die Prüfung nie ausgeführt hat, hat gar keine getroffen.</p>
+    </section>
+
+    <section aria-labelledby="profiles">
+      <h2 id="profiles">Render-Profile</h2>
+      <p>Eine Implementierung bietet mindestens zwei Profile an, beide auswählbar, und benennt, welches ein bestimmter Lauf verwendet hat:</p>
+      <ul>
+        <li><strong>strikt</strong> — lässt den Lauf bei jedem berechneten nicht-ok-Zustand fehlschlagen, über den Exit-Status und nicht nur im Text.</li>
+        <li><strong>tolerant</strong> — schlägt nicht fehl; stellt jede auflösbare Referenz dar, jede nicht-ok mit ihrem Kennzeichen, und meldet jeden gefundenen Zustand.</li>
+      </ul>
+      <p>Zwei Regeln binden das Paar aneinander: Das tolerante Profil erkennt <em>genau</em> das, woran das strikte scheitert — keine Teilmenge davon — und keines der beiden stellt eine nicht-ok-Referenz als ihren blanken Wert dar. Die Namen oben bezeichnen die Rollen, nicht eine vorgeschriebene Schreibweise.</p>
+      <p>Eine Implementierung darf jedes Konstrukt der Sprache unimplementiert lassen; eine Teilmenge zu unterstützen ist der erwartete Fall. Was sie in ihrer eigenen Dokumentation angibt, sind beide Hälften: was sie unterstützt und was sie erkennt und ablehnt. Ein erkanntes, aber nicht implementiertes Konstrukt schlägt unter eben diesem Namen fehl, mit einem Code, der sich von dem für unbekannte oder fehlerhafte Syntax unterscheidet — die beiden Meldungen lauten <em>das gehört nicht zur Sprache</em> und <em>das gehört zur Sprache und nicht zu diesem Werkzeug</em>, und sie schicken einen Autor an verschiedene Stellen.</p>
+    </section>
+
+    <section aria-labelledby="today">
+      <h2 id="today">Was heute existiert</h2>
+      <ul>
+        <li><strong>Die normative Spezifikation</strong> — <a href="https://github.com/transitrix/methodology/blob/main/notations/views/documents/DIRECTIVE_LANGUAGE.md">DIRECTIVE_LANGUAGE.md</a>, Version 1.0, stabil, vom 2026-08-07. Sie ist ein Konformitätsvertrag, geschrieben, um dagegen zu bauen, und definiert die Sprache einmal für jede Quelle, die sie verwendet. Wo sie und eine Implementierung sich widersprechen, gilt die Spezifikation.</li>
+        <li><strong>Die Referenzimplementierung</strong> — <a href="https://github.com/transitrix/methodology/blob/main/packages/document-renderer/README.md">@transitrix/document-renderer</a>, der Parser und sein deterministischer erster Durchlauf. Sie existiert, um die Spezifikation prüfbar zu machen, und ihre README benennt, welche Konstrukte sie unterstützt und welche sie zurückstellt.</li>
+        <li><strong>Das Konformitätsbeispiel</strong> — eine vollständige Quelldatei und ihre eingefrorene Ausgabe, gemeinsam eingecheckt. Es ist das Artefakt, gegen das eine unabhängige Implementierung ihre eigene Ausgabe diffed, und es wird nie neu erzeugt.</li>
+        <li><strong>Die heute spezifizierten Arten</strong> — <a href="https://github.com/transitrix/methodology/blob/main/notations/views/documents/29-mrd.md">29-mrd.md</a>, <a href="https://github.com/transitrix/methodology/blob/main/notations/views/documents/30-srs.md">30-srs.md</a>, <a href="https://github.com/transitrix/methodology/blob/main/notations/views/documents/31-sdd.md">31-sdd.md</a>, von denen jede ein Layout definiert und keine Sprache.</li>
+      </ul>
+      <div class="note">
+        <strong>Weiterlesen</strong> — das Verzeichnis dieser Klasse ist <a href="https://github.com/transitrix/methodology/blob/main/notations/views/documents/README.md">notations/views/documents/README.md</a>; die gemeinsamen Kopf- und Endungsregeln, denen jede Notation folgt, stehen in <a href="https://github.com/transitrix/methodology/blob/main/notations/CONTRACT.md">CONTRACT.md</a>. Für die YAML-Notationen und ihre Dateistrukturen siehe die <a href="/de/dsl-examples/">DSL-Beispiele</a>.
+      </div>
+    </section>
+  </main>
+  <footer class="site-footer">
+    <div class="wrap footer-inner">
+      <p>
+        <a href="https://github.com/transitrix">github.com/transitrix</a> ·
+        <a href="https://x.com/transitrix">@transitrix</a> ·
+        <a href="https://vkgeorgia.github.io">vkgeorgia.github.io</a>
+      </p>
+      <nav class="lang-switch" aria-label="Sprache">
+        <a href="../../ttrs/" hreflang="en">EN</a>
+        <a href="./" aria-current="true">DE</a>
+      </nav>
+    </div>
+  </footer>
+  <script src="../../assets/js/theme.js"></script>
+</body>
+</html>
diff --git a/dsl-examples/index.html b/dsl-examples/index.html
index 06eb579..123b343 100644
--- a/dsl-examples/index.html
+++ b/dsl-examples/index.html
@@ -486,6 +486,7 @@ <h2 id="next-heading">Next</h2>
       <ul>
         <li>Full methodology specification: <a href="https://github.com/transitrix/methodology">github.com/transitrix/methodology</a></li>
         <li>Every notation spec: <a href="https://github.com/transitrix/methodology/tree/main/notations">notations on GitHub</a></li>
+        <li>Document sources, the other file shape: <a href="/ttrs/">the <code>.ttrs</code> document source format</a></li>
         <li>JSON Schemas: <a href="https://github.com/transitrix/transitrix-studio/tree/main/schemas">schemas on GitHub</a></li>
         <li>Machine-readable project summary: <a href="/llms.txt">llms.txt</a></li>
         <li>Install Studio to preview any of the above live: <a href="/install/">install &amp; start →</a></li>
diff --git a/index.html b/index.html
index 2766b0e..8388400 100644
--- a/index.html
+++ b/index.html
@@ -144,7 +144,7 @@ <h2 id="layers-heading">One model, every layer</h2>
 
     <section aria-labelledby="open-heading">
       <h2 id="open-heading">What's open today</h2>
-      <p>Both the methodology and Transitrix Studio are public. The methodology specification lives at <a href="https://github.com/transitrix/methodology">github.com/transitrix/methodology</a>. Transitrix Studio — an editor extension and CLI — installs into VS Code, Cursor, VSCodium, Windsurf and IntelliJ IDEA; see the <a href="install/">install options</a>. Source at <a href="https://github.com/transitrix/transitrix-studio">github.com/transitrix/transitrix-studio</a>. For the exact shape of every notation, see the <a href="dsl-examples/">DSL examples</a> reference.</p>
+      <p>Both the methodology and Transitrix Studio are public. The methodology specification lives at <a href="https://github.com/transitrix/methodology">github.com/transitrix/methodology</a>. Transitrix Studio — an editor extension and CLI — installs into VS Code, Cursor, VSCodium, Windsurf and IntelliJ IDEA; see the <a href="install/">install options</a>. Source at <a href="https://github.com/transitrix/transitrix-studio">github.com/transitrix/transitrix-studio</a>. For the exact shape of every notation, see the <a href="dsl-examples/">DSL examples</a> reference; document sources — prose with directives, named <code>*.&lt;kind&gt;.ttrs</code> — are described on <a href="ttrs/">the <code>.ttrs</code> document source format</a> page.</p>
       <p>If you are evaluating Transitrix for a pilot or want to follow the work, reach out at <a href="mailto:hello@transitrix.com">hello@transitrix.com</a>.</p>
       <div class="note">
         <strong>Follow releases</strong> — subscribe via Atom/RSS: <a href="https://github.com/transitrix/transitrix-studio/releases.atom">Transitrix Studio</a> · <a href="https://github.com/transitrix/methodology/releases.atom">Methodology</a>. Add either URL to any RSS/Atom reader, or use GitHub's Watch → Releases on each repository.
diff --git a/llms.txt b/llms.txt
index 8074b59..b54044b 100644
--- a/llms.txt
+++ b/llms.txt
@@ -2,11 +2,14 @@
 
 > Transitrix: open methodology and tools to describe an enterprise as text — and let humans and machines run it together. An open research initiative: ArchiMate-grounded, business-layer, one formal model projected across every architectural layer, authored as plain YAML in git.
 
-Transitrix source files are plain YAML. Every file carries a `notation:` key naming its format and a `*.<notation>.transitrix.yaml` filename suffix — there is no `type:`/`version:` wrapper, no single-key `flow:` array, no `next:`-based sequencing. Do not invent a shape; use the canonical examples linked below.
+Most Transitrix source files are plain YAML: a `notation:` key naming the format and a `*.<notation>.transitrix.yaml` filename suffix — there is no `type:`/`version:` wrapper, no single-key `flow:` array, no `next:`-based sequencing. Document sources are the other shape: prose with `{{ … }}` directives, named `*.<kind>.ttrs`, where the middle segment is the document kind (`product.mrd.ttrs`) and never a notation.
+
+Each notation has exactly one canonical extension — either `*.<short-name>.transitrix.yaml` or `*.<short-name>.ttrs` — and which one it takes is a property of that notation. `.ttrs` replaces the longer suffix in full for the notation that takes it; it is never appended to it, and no notation carries both. Do not invent a shape; use the canonical examples linked below.
 
 ## Canonical reference
 
 - [DSL examples](https://transitrix.com/dsl-examples/): One minimal, schema-valid YAML example per notation Transitrix Studio ships (BPMN, goals, DGCA, capability maps, process maps, process blueprints, activity networks, activity cards, scenarios, applications, products, nested blocks, compliance impact) — copy-paste ready, all on one page.
+- [Document source format `.ttrs`](https://transitrix.com/ttrs/): What a `.ttrs` source file contains, how `<basename>.<kind>.ttrs` is read, the `{{ … }}` directive language, and the reference states an implementation must distinguish. Links the normative specification, the reference implementation and the conformance fixture.
 - [Notation specs](https://github.com/transitrix/methodology/tree/main/notations): The full specification for every notation, with larger worked examples per format.
 - [JSON Schemas](https://github.com/transitrix/transitrix-studio/tree/main/schemas): Machine-checkable schemas backing the notations.
 
diff --git a/robots.txt b/robots.txt
new file mode 100644
index 0000000..3204a2c
--- /dev/null
+++ b/robots.txt
@@ -0,0 +1,8 @@
+User-agent: *
+Allow: /
+
+# The /install/go/ paths are redirects to external download pages. They carry
+# their own noindex, so they stay crawlable — a Disallow here would hide that
+# instruction from the crawler that needs to read it.
+
+Sitemap: https://transitrix.com/sitemap.xml
diff --git a/sitemap.xml b/sitemap.xml
new file mode 100644
index 0000000..ef5e4b4
--- /dev/null
+++ b/sitemap.xml
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
+        xmlns:xhtml="http://www.w3.org/1999/xhtml">
+
+  <url>
+    <loc>https://transitrix.com/</loc>
+    <xhtml:link rel="alternate" hreflang="en" href="https://transitrix.com/"/>
+    <xhtml:link rel="alternate" hreflang="de" href="https://transitrix.com/de/"/>
+  </url>
+  <url>
+    <loc>https://transitrix.com/install/</loc>
+    <xhtml:link rel="alternate" hreflang="en" href="https://transitrix.com/install/"/>
+    <xhtml:link rel="alternate" hreflang="de" href="https://transitrix.com/de/install/"/>
+  </url>
+  <url>
+    <loc>https://transitrix.com/quickstart/</loc>
+    <xhtml:link rel="alternate" hreflang="en" href="https://transitrix.com/quickstart/"/>
+    <xhtml:link rel="alternate" hreflang="de" href="https://transitrix.com/de/quickstart/"/>
+  </url>
+  <url>
+    <loc>https://transitrix.com/dsl-examples/</loc>
+    <xhtml:link rel="alternate" hreflang="en" href="https://transitrix.com/dsl-examples/"/>
+    <xhtml:link rel="alternate" hreflang="de" href="https://transitrix.com/de/dsl-examples/"/>
+  </url>
+  <url>
+    <loc>https://transitrix.com/ttrs/</loc>
+    <xhtml:link rel="alternate" hreflang="en" href="https://transitrix.com/ttrs/"/>
+    <xhtml:link rel="alternate" hreflang="de" href="https://transitrix.com/de/ttrs/"/>
+  </url>
+  <url>
+    <loc>https://transitrix.com/dsm/</loc>
+    <xhtml:link rel="alternate" hreflang="en" href="https://transitrix.com/dsm/"/>
+    <xhtml:link rel="alternate" hreflang="de" href="https://transitrix.com/de/dsm/"/>
+  </url>
+  <url>
+    <loc>https://transitrix.com/strategy-and-behaviour/</loc>
+    <xhtml:link rel="alternate" hreflang="en" href="https://transitrix.com/strategy-and-behaviour/"/>
+    <xhtml:link rel="alternate" hreflang="de" href="https://transitrix.com/de/strategy-and-behaviour/"/>
+  </url>
+
+  <url>
+    <loc>https://transitrix.com/de/</loc>
+    <xhtml:link rel="alternate" hreflang="de" href="https://transitrix.com/de/"/>
+    <xhtml:link rel="alternate" hreflang="en" href="https://transitrix.com/"/>
+  </url>
+  <url>
+    <loc>https://transitrix.com/de/install/</loc>
+    <xhtml:link rel="alternate" hreflang="de" href="https://transitrix.com/de/install/"/>
+    <xhtml:link rel="alternate" hreflang="en" href="https://transitrix.com/install/"/>
+  </url>
+  <url>
+    <loc>https://transitrix.com/de/quickstart/</loc>
+    <xhtml:link rel="alternate" hreflang="de" href="https://transitrix.com/de/quickstart/"/>
+    <xhtml:link rel="alternate" hreflang="en" href="https://transitrix.com/quickstart/"/>
+  </url>
+  <url>
+    <loc>https://transitrix.com/de/dsl-examples/</loc>
+    <xhtml:link rel="alternate" hreflang="de" href="https://transitrix.com/de/dsl-examples/"/>
+    <xhtml:link rel="alternate" hreflang="en" href="https://transitrix.com/dsl-examples/"/>
+  </url>
+  <url>
+    <loc>https://transitrix.com/de/ttrs/</loc>
+    <xhtml:link rel="alternate" hreflang="de" href="https://transitrix.com/de/ttrs/"/>
+    <xhtml:link rel="alternate" hreflang="en" href="https://transitrix.com/ttrs/"/>
+  </url>
+  <url>
+    <loc>https://transitrix.com/de/dsm/</loc>
+    <xhtml:link rel="alternate" hreflang="de" href="https://transitrix.com/de/dsm/"/>
+    <xhtml:link rel="alternate" hreflang="en" href="https://transitrix.com/dsm/"/>
+  </url>
+  <url>
+    <loc>https://transitrix.com/de/strategy-and-behaviour/</loc>
+    <xhtml:link rel="alternate" hreflang="de" href="https://transitrix.com/de/strategy-and-behaviour/"/>
+    <xhtml:link rel="alternate" hreflang="en" href="https://transitrix.com/strategy-and-behaviour/"/>
+  </url>
+
+</urlset>
diff --git a/ttrs/index.html b/ttrs/index.html
new file mode 100644
index 0000000..0d6826c
--- /dev/null
+++ b/ttrs/index.html
@@ -0,0 +1,200 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>The .ttrs document source format | Transitrix</title>
+  <meta name="description" content="The .ttrs document source format: what a source file contains, how the filename's middle segment names the document kind, the directive language, and the reference states an implementation must distinguish.">
+  <link rel="canonical" href="/ttrs/">
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Sans:ital,wght@0,400;0,600;1,400&family=IBM+Plex+Mono:wght@400&display=swap" rel="stylesheet">
+  <link rel="stylesheet" href="../assets/css/style.css">
+  <link rel="icon" type="image/png" sizes="128x128" href="/assets/img/favicon-128.png">
+  <link rel="apple-touch-icon" sizes="256x256" href="/assets/img/apple-touch-icon.png">
+  <link rel="alternate" hreflang="de" href="../de/ttrs/">
+  <link rel="alternate" hreflang="en" href="./">
+  <script>if(localStorage.getItem('theme')==='light')document.documentElement.setAttribute('data-theme','light');</script>
+  <!-- Cloudflare Web Analytics -->
+  <script defer src="https://static.cloudflareinsights.com/beacon.min.js" data-cf-beacon='{"token": "1d2971bbe7964ede92ee02e5c78da48c"}'></script>
+  <!-- End Cloudflare Web Analytics -->
+</head>
+<body>
+  <a class="skip-link" href="#main">Skip to main content</a>
+  <header class="site-header">
+    <div class="wrap">
+      <a class="logo" href="../">Transitrix</a>
+      <div class="header-right">
+        <button class="theme-toggle" id="theme-toggle" aria-label="Toggle theme">
+          <svg class="icon-moon" width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"/></svg>
+          <svg class="icon-sun" width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="5"/><line x1="12" y1="1" x2="12" y2="3"/><line x1="12" y1="21" x2="12" y2="23"/><line x1="4.22" y1="4.22" x2="5.64" y2="5.64"/><line x1="18.36" y1="18.36" x2="19.78" y2="19.78"/><line x1="1" y1="12" x2="3" y2="12"/><line x1="21" y1="12" x2="23" y2="12"/><line x1="4.22" y1="19.78" x2="5.64" y2="18.36"/><line x1="18.36" y1="5.64" x2="19.78" y2="4.22"/></svg>
+        </button>
+        <nav class="lang-switch" aria-label="Language">
+          <a href="./" aria-current="true">EN</a>
+          <a href="../de/ttrs/" hreflang="de">DE</a>
+        </nav>
+      </div>
+    </div>
+  </header>
+  <main id="main" class="wrap">
+    <div class="hero">
+      <h1>The <code>.ttrs</code> document source format</h1>
+      <p class="lede">A document source is prose with <code>{{ … }}</code> directives in it. The prose is copied through as written; each directive names something in a Transitrix model and is replaced by what it resolves to.</p>
+    </div>
+
+    <section aria-labelledby="jump-heading">
+      <h2 id="jump-heading">On this page</h2>
+      <ul class="qs-viewers">
+        <li><a href="#file">What a source file contains</a> · <a href="#filename">How the filename is read</a></li>
+        <li><a href="#language">The directive language</a> · <a href="#fragment">A worked fragment</a></li>
+        <li><a href="#states">Reference states</a> · <a href="#profiles">Render profiles</a></li>
+        <li><a href="#today">What exists today</a></li>
+      </ul>
+    </section>
+
+    <section aria-labelledby="file">
+      <h2 id="file">What a source file contains</h2>
+      <p>One text file, in two parts: a YAML header, then the document body.</p>
+      <p>The body is ordinary prose. Everything outside <code>{{ … }}</code> is fixed text and is copied through verbatim; each <code>{{ … }}</code> is a directive that names something in the model and is replaced by what it resolves to.</p>
+      <div class="code-wrapper">
+        <button class="copy-btn" data-copy-label="Copy" data-copied-label="Copied ✓" aria-label="Copy the header example to clipboard">Copy</button>
+        <pre><code>---
+document: Market Requirements Document   # required — the name its readers use
+kind: mrd                                # required — matches the filename's middle segment
+template_id: product.mrd                 # required — named in the run record
+template_version: "1.0"                  # required — named in the run record
+canon: ../canon                          # optional — the model repository
+---</code></pre>
+      </div>
+      <p>Four header fields are required; <code>canon:</code> is not. A source that names no model object and no derived figure resolves standalone, with no repository configured at all — that is a legitimate input in its own right, and an implementation reading such a source reports the no-repository state rather than treating it as a failed lookup.</p>
+    </section>
+
+    <section aria-labelledby="filename">
+      <h2 id="filename">How the filename is read</h2>
+      <div class="code-wrapper">
+        <pre><code>&lt;basename&gt;.&lt;kind&gt;.ttrs        e.g.  product.mrd.ttrs
+                                    platform.srs.ttrs
+                                    gateway.sdd.ttrs</code></pre>
+      </div>
+      <p><strong>The middle segment is the document <em>kind</em> — never a notation.</strong> A kind is a layout over the model: which elements a document of that kind selects, and how they are arranged. It carries no content of its own, gets no directive language of its own, and a new kind never means a new language. The kinds specified today are <code>mrd</code>, <code>srs</code>, <code>sdd</code> and <code>sds</code>; the header's <code>kind:</code> must agree with the filename.</p>
+      <p>Each notation has exactly one canonical extension, and it is either <code>*.&lt;short-name&gt;.transitrix.yaml</code> or <code>*.&lt;short-name&gt;.ttrs</code>. Which one a given notation takes is a property of that notation. Where <code>.ttrs</code> applies it replaces the longer suffix in full — it is never appended to it, and no notation carries both.</p>
+      <p><code>.trs</code> is one keystroke away and is a different, widely used format. A file ending <code>.trs</code> where a document source is expected is reported as that near-miss by name, not as an unknown file.</p>
+    </section>
+
+    <section aria-labelledby="language">
+      <h2 id="language">The directive language</h2>
+      <p>Delimiters are <code>{{</code> and <code>}}</code>. Whitespace just inside them is insignificant, so <code>{{REQ-14}}</code> and <code>{{ REQ-14 }}</code> are the same directive. <code>\{{</code> renders a literal <code>{{</code> and is the only escape in the language. No directive nests inside another, except that the two block forms below take a body.</p>
+
+      <h3>Inline forms</h3>
+      <ul>
+        <li><code>{{ REQ-14 }}</code> — <strong>inline reference.</strong> Substitutes the named object's display value.</li>
+        <li><code>{{ REQ-14.parent.title }}</code> — <strong>field path.</strong> Substitutes one field, walking through any middle segment that itself names an object. <strong>Traversal is capped at depth 3</strong>, and a longer path is a failure rather than a deeper walk.</li>
+        <li><code>{{ .field }}</code> — <strong>row reference.</strong> A field of the current row of the enclosing <code>each</code> block, and meaningful only inside one.</li>
+        <li><code>{{ trace from = … to = … via = … }}</code> — <strong>trace.</strong> Renders trace coverage between two element types along one relation; all three attributes are required.</li>
+        <li><code>{{ view &lt;path&gt; [as = …] [fit = width|page|none] }}</code> — <strong>derived figure.</strong> A view authored in an existing notation and rendered from the model. <code>fit</code> defaults to <code>width</code>.</li>
+        <li><code>{{ figure &lt;path&gt; [caption = "…"] [as = …] }}</code> — <strong>supplied figure.</strong> An asset embedded as it is; never generated.</li>
+        <li><code>{{ figref &lt;name&gt; }}</code> — <strong>figure cross-reference</strong>, by the <code>as</code> name of a figure declared earlier in the same document. Figures are numbered in document order, and a forward reference is a failure rather than a deferred lookup.</li>
+      </ul>
+
+      <h3>Block forms — there are exactly two</h3>
+      <p><code>{{# each &lt;TYPE&gt; [where …] [order by &lt;field&gt;] }} … {{/ each }}</code> repeats its body once per selected element, binding each in turn as the current row. The <code>where</code> clause is deliberately small: <code>and</code> only, no <code>or</code> and no parentheses; <code>=</code> and <code>!=</code> only; a literal on the right-hand side, never another field. <code>order by</code> takes a single field, and is what makes a rendered document reproducible.</p>
+      <p><code>{{# instruct &lt;slot-id&gt; }} … {{/ instruct }}</code> declares an instruction slot — a section a deterministic pass does not fill, carrying <code>question:</code> and <code>sufficient:</code> (both required) and an optional comma-separated <code>inputs:</code>. <strong>A slot body is opaque:</strong> a parser scans from the opening tag straight to the matching close and keeps everything between as raw text, so a <code>{{ REQ-14 }}</code> written inside a slot is instruction prose and is never resolved. Slot ids are lower-case letters, digits and hyphens, and must be unique within a document.</p>
+
+      <h3>Identifiers</h3>
+      <p>An id follows the canonical grammar — <code>REQ-14</code>, <code>CAP-1</code>, <code>BUSINESS_SERVICE-3</code>. A capability id embeds a diagram address whose dots belong to the id, so a parser splits the <code>CAPABILITY-V</code> / <code>CAPABILITY-H</code> prefix off before it reads a field path: <code>{{ CAPABILITY-V1.2.3 }}</code> is one id and no field path, while <code>{{ CAPABILITY-V1.2.3.name }}</code> is that same id with the field path <code>name</code>.</p>
+    </section>
+
+    <section aria-labelledby="fragment">
+      <h2 id="fragment">A worked fragment</h2>
+      <p>The committed conformance fixture, in full — a header, fixed text, a reference, a field path, a two-step path, a derived figure with a cross-reference to it, and one instruction slot.</p>
+      <div class="code-wrapper">
+        <button class="copy-btn" data-copy-label="Copy" data-copied-label="Copied ✓" aria-label="Copy the worked fragment to clipboard">Copy</button>
+        <pre><code>---
+document: Market Requirements Document
+kind: mrd
+template_id: product.mrd
+template_version: "1.0"
+canon: canon
+---
+# {{ CAP-1.title }}
+
+## Scope
+
+This document covers {{ CAP-1.text }}
+
+## Requirements
+
+**{{ REQ-14 }}** — {{ REQ-14.text }}
+
+Its parent capability is {{ REQ-14.parent.name }}.
+
+{{ view diagrams/context.blocks.transitrix.yaml as = context fit = width }}
+
+{{ figref context }} shows where the capability sits.
+
+## Market
+
+{{# instruct market-size }}
+question: How large is the addressable market for this capability, and how fast is it growing?
+inputs: CAP-1, REQ-14
+sufficient: A market size with a currency and a year, a growth rate, and the method used to derive both.
+{{/ instruct }}</code></pre>
+      </div>
+      <p>The file is <a href="https://github.com/transitrix/methodology/blob/main/packages/document-renderer/tests/fixtures/product.mrd.ttrs">product.mrd.ttrs</a>, and the output it must produce is frozen beside it as <a href="https://github.com/transitrix/methodology/blob/main/packages/document-renderer/tests/fixtures/product.mrd.expected.md">product.mrd.expected.md</a>.</p>
+    </section>
+
+    <section aria-labelledby="states">
+      <h2 id="states">Reference states</h2>
+      <p>Resolving a reference yields exactly one state. Besides <em>ok</em> — resolved, admitted, and inside its validity interval — the language names five, and <strong>an implementation must keep every state it reports distinct from every other.</strong></p>
+      <ul>
+        <li><strong>unresolved</strong> <code>⚑U</code> — no object with that id exists.</li>
+        <li><strong>not admitted</strong> <code>⚑A</code> — the object exists, but its admission state is not active.</li>
+        <li><strong>out of validity</strong> <code>⚑V</code> — its validity interval does not cover the render date.</li>
+        <li><strong>suspect</strong> <code>⚑S</code> — the object resolves, but the link to it is under suspicion.</li>
+        <li><strong>no repository configured</strong> — the document cites the model, and none is configured.</li>
+      </ul>
+      <p>The first three are classified in that order: existence, then admission, then validity. Collapsing any two states into one is non-conformance rather than a simplification — <em>you have no repository</em> and <em>your repository lacks this id</em> are different problems with different fixes, and each state names a different thing for its reader to go and do.</p>
+      <p><strong>A non-ok reference never renders as its bare value.</strong> The state that reads as correct text is the one a reader has no way to see.</p>
+      <p><code>⚑S</code> is derived from commit history rather than read from a file, and is the one state an implementation may decline to compute. Declining is permitted; being silent about it is not — three outcomes have to stay distinguishable: <em>suspect</em>, <em>checked and clean</em>, and <em>never checked</em>. A document that renders with no <code>⚑S</code> anywhere is making a claim, and an implementation that never ran the check has made no claim at all.</p>
+    </section>
+
+    <section aria-labelledby="profiles">
+      <h2 id="profiles">Render profiles</h2>
+      <p>An implementation offers at least two profiles, both selectable, and names which one a given run used:</p>
+      <ul>
+        <li><strong>strict</strong> — fails the run on every non-ok state it computes, by exit status and not only in prose.</li>
+        <li><strong>lenient</strong> — does not fail; renders each reference it can, every non-ok one carrying its flag, and reports every state it found.</li>
+      </ul>
+      <p>Two rules bind the pair: the lenient profile detects <em>exactly</em> what the strict one fails on — not a subset — and neither profile renders a non-ok reference as its bare value. The names above are the roles rather than a required spelling.</p>
+      <p>An implementation may leave any construct of the language unimplemented, and admitting a subset is expected. What it states in its own documentation is both halves: what it admits, and what it recognises and declines. A recognised-but-unimplemented construct fails by that name, under a code distinct from the one used for unknown or malformed syntax — the two messages are <em>this is not in the language</em> and <em>this is in the language and not in this tool</em>, and they send an author to different places.</p>
+    </section>
+
+    <section aria-labelledby="today">
+      <h2 id="today">What exists today</h2>
+      <ul>
+        <li><strong>The normative specification</strong> — <a href="https://github.com/transitrix/methodology/blob/main/notations/views/documents/DIRECTIVE_LANGUAGE.md">DIRECTIVE_LANGUAGE.md</a>, version 1.0, stable, dated 2026-08-07. It is a conformance contract written to be built against, and it defines the language once for every source that uses it. Where it and any implementation disagree, the specification wins.</li>
+        <li><strong>The reference implementation</strong> — <a href="https://github.com/transitrix/methodology/blob/main/packages/document-renderer/README.md">@transitrix/document-renderer</a>, the parser and its deterministic first pass. It exists to make the specification checkable, and its README states which constructs it admits and which it defers.</li>
+        <li><strong>The conformance fixture</strong> — a complete source file and its frozen output, committed together. It is the artefact an independent implementation diffs its own output against, and it is never regenerated.</li>
+        <li><strong>The kinds specified today</strong> — <a href="https://github.com/transitrix/methodology/blob/main/notations/views/documents/29-mrd.md">29-mrd.md</a>, <a href="https://github.com/transitrix/methodology/blob/main/notations/views/documents/30-srs.md">30-srs.md</a>, <a href="https://github.com/transitrix/methodology/blob/main/notations/views/documents/31-sdd.md">31-sdd.md</a>, each defining a layout rather than a language.</li>
+      </ul>
+      <div class="note">
+        <strong>Reading further</strong> — the class index is <a href="https://github.com/transitrix/methodology/blob/main/notations/views/documents/README.md">notations/views/documents/README.md</a>; the shared header and extension rules every notation follows are in <a href="https://github.com/transitrix/methodology/blob/main/notations/CONTRACT.md">CONTRACT.md</a>. For the YAML notations and their file shapes, see the <a href="/dsl-examples/">DSL examples</a>.
+      </div>
+    </section>
+  </main>
+  <footer class="site-footer">
+    <div class="wrap footer-inner">
+      <p>
+        <a href="https://github.com/transitrix">github.com/transitrix</a> ·
+        <a href="https://x.com/transitrix">@transitrix</a> ·
+        <a href="https://vkgeorgia.github.io">vkgeorgia.github.io</a>
+      </p>
+      <nav class="lang-switch" aria-label="Language">
+        <a href="./" aria-current="true">EN</a>
+        <a href="../de/ttrs/" hreflang="de">DE</a>
+      </nav>
+    </div>
+  </footer>
+  <script src="../assets/js/theme.js"></script>
+</body>
+</html>