site: add a page for the .ttrs document source format, plus robots.txt and sitemap.xml

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>

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.

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>

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.

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.
 

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

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>