Add a glossary page with Schema.org markup

MANIFEST.md

@@ -51,6 +51,7 @@ admits future files.
 - `explainers/what-is-architecture-as-code/index.html`
 - `explainers/what-is-architecture-as-code/what-is-architecture-as-code.pdf`
 - `favicon.ico`
+- `glossary/index.html`
 - `index.html`
 - `install/go/claude/index.html`
 - `install/go/jetbrains/index.html`

glossary/index.html

@@ -0,0 +1,145 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Transitrix Glossary | Transitrix</title>
+  <meta name="description" content="Definitions for Architecture-as-Code, Element, Atomicity, and Canon from the Transitrix Methodology.">
+  <link rel="canonical" href="https://transitrix.com/glossary/">
+  <meta property="og:type" content="website">
+  <meta property="og:url" content="https://transitrix.com/glossary/">
+  <meta property="og:title" content="Transitrix Glossary | Transitrix">
+  <meta property="og:description" content="Definitions for Architecture-as-Code, Element, Atomicity, and Canon from the Transitrix Methodology.">
+  <meta property="og:image" content="https://transitrix.com/assets/og/transitrix-og.png">
+  <meta property="og:image:width" content="1200">
+  <meta property="og:image:height" content="630">
+  <meta property="og:locale" content="en_US">
+  <meta property="og:locale:alternate" content="de_DE">
+  <meta name="twitter:card" content="summary_large_image">
+  <meta name="twitter:image" content="https://transitrix.com/assets/og/transitrix-og.png">
+  <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/svg+xml" href="/assets/img/transitrix-icon.svg">
+  <link rel="icon" type="image/png" sizes="16x16" href="/assets/img/favicon-16.png">
+  <link rel="icon" type="image/png" sizes="32x32" href="/assets/img/favicon-32.png">
+  <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">
+  <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 -->
+  <script type="application/ld+json">
+{
+  "@context": {
+    "@vocab": "https://schema.org/"
+  },
+  "@type": "DefinedTermSet",
+  "@id": "https://transitrix.com/glossary/#glossary",
+  "url": "https://transitrix.com/glossary/",
+  "name": "Transitrix Glossary",
+  "inLanguage": "en",
+  "hasDefinedTerm": [
+    {
+      "@type": "DefinedTerm",
+      "@id": "https://transitrix.com/glossary/#architecture-as-code",
+      "name": "Architecture-as-Code (AaC)",
+      "description": "Approach to defining and managing architecture through version-controlled text files rather than a GUI-only modelling tool.",
+      "inDefinedTermSet": {
+        "@id": "https://transitrix.com/glossary/#glossary"
+      }
+    },
+    {
+      "@type": "DefinedTerm",
+      "@id": "https://transitrix.com/glossary/#element",
+      "name": "Element",
+      "description": "An architectural primitive — the atomic unit of modelling (a goal, a role, a process, an application component). One element = one file.",
+      "inDefinedTermSet": {
+        "@id": "https://transitrix.com/glossary/#glossary"
+      }
+    },
+    {
+      "@type": "DefinedTerm",
+      "@id": "https://transitrix.com/glossary/#atomicity",
+      "name": "Atomicity",
+      "description": "Principle by which an element's description and its relations are stored in separate files — an element file never inlines a first-class relation.",
+      "inDefinedTermSet": {
+        "@id": "https://transitrix.com/glossary/#glossary"
+      }
+    },
+    {
+      "@type": "DefinedTerm",
+      "@id": "https://transitrix.com/glossary/#canon",
+      "name": "Canon",
+      "description": "The validated, authoritative model — the zone everything else is admitted into.",
+      "inDefinedTermSet": {
+        "@id": "https://transitrix.com/glossary/#glossary"
+      }
+    }
+  ]
+}
+  </script>
+</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>
+      </div>
+      <nav class="site-nav" aria-label="Primary">
+        <ul>
+          <li><a href="/learn/">Learn</a></li>
+          <li><a href="/dsl-examples/">Examples</a></li>
+          <li><a href="https://github.com/transitrix/methodology" target="_blank" rel="noopener noreferrer">Methodology</a></li>
+          <li><a href="/library/">Library</a></li>
+          <li><a href="/install/">Install &amp; start</a></li>
+        </ul>
+      </nav>
+    </div>
+  </header>
+  <main id="main" class="wrap" tabindex="-1">
+    <div class="hero">
+      <h1 id="glossary">Transitrix Glossary</h1>
+      <p class="lede">Four terms from the <a href="https://github.com/transitrix/methodology/blob/27cc5c302c9dfb9f66d184c003007f5527b1010e/method/00-glossary.md">Transitrix Methodology v8.0.0 glossary</a>.</p>
+    </div>
+
+    <section aria-labelledby="architecture-as-code">
+      <h2 id="architecture-as-code">Architecture-as-Code (AaC)</h2>
+      <p>Approach to defining and managing architecture through version-controlled text files rather than a GUI-only modelling tool.</p>
+    </section>
+
+    <section aria-labelledby="element">
+      <h2 id="element">Element</h2>
+      <p>An architectural primitive — the atomic unit of modelling (a goal, a role, a process, an application component). One element = one file.</p>
+    </section>
+
+    <section aria-labelledby="atomicity">
+      <h2 id="atomicity">Atomicity</h2>
+      <p>Principle by which an element&#x27;s description and its relations are stored in separate files — an element file never inlines a first-class relation.</p>
+    </section>
+
+    <section aria-labelledby="canon">
+      <h2 id="canon">Canon</h2>
+      <p>The validated, authoritative model — the zone everything else is admitted into.</p>
+    </section>
+  </main>
+  <footer class="site-footer">
+    <div class="wrap">
+      <div class="footer-inner">
+        <p>
+          <a href="https://github.com/transitrix">github.com/transitrix</a> ·
+          <a href="https://x.com/transitrix">@transitrix</a>
+        </p>
+      </div>
+      <p class="footer-attribution">Created and maintained by Valerii Korobeinikov — enterprise-architecture advisory at <a href="https://korobeinikov.consulting">korobeinikov.consulting</a></p>
+    </div>
+  </footer>
+  <script src="../assets/js/theme.js"></script>
+</body>
+</html>

semantic-standards/index.html

@@ -59,6 +59,8 @@ <h1>Semantic Standards and Interoperability</h1>
       <p class="lede">Keep the meaning when a model crosses a boundary: identity, context, mapping limits and evidence matter as much as the format.</p>
     </div>
 
+    <p>For definitions of core modelling terms, see the <a href="/glossary/">Transitrix Glossary</a>.</p>
+
     <section aria-labelledby="foundations-heading">
       <h2 id="foundations-heading">A foundation, with explicit differences</h2>
       <p>Transitrix uses plain-text models under Git. ArchiMate 3.2 is a starting foundation, alongside BPMN for process modelling. Transitrix also makes deliberate choices about identity, time, stakeholder interests and evidence. Better model representation takes precedence over strict fidelity.</p>

sitemap.xml

@@ -45,6 +45,10 @@
     <loc>https://transitrix.com/explainers/what-is-architecture-as-code/</loc>
     <xhtml:link rel="alternate" hreflang="en" href="https://transitrix.com/explainers/what-is-architecture-as-code/"/>
   </url>
+  <url>
+    <loc>https://transitrix.com/glossary/</loc>
+    <xhtml:link rel="alternate" hreflang="en" href="https://transitrix.com/glossary/"/>
+  </url>
   <url>
     <loc>https://transitrix.com/install/</loc>
     <xhtml:link rel="alternate" hreflang="en" href="https://transitrix.com/install/"/>