LLM-Coding · rdmueller · Jun 10, 2026 · Jun 10, 2026
diff --git a/docs/changelog.adoc b/docs/changelog.adoc
@@ -2,6 +2,14 @@
 
 A chronological record of all semantic anchors added to the catalog. Community contributors are credited with thanks.
 
+== 2026-06-11
+
+*Share metadata & descriptions (#601):*
+
+* *Per-page Open Graph / Twitter cards* — every pre-rendered page now carries its own `og:url`, `og:title`, `og:description` and `twitter:*` tags (previously all subpages shipped the home-page values, so sharing an anchor link rendered the generic home preview). German pages get `og:locale=de_DE`.
+* *Accurate home description* — the hard-coded "110+ semantic anchors" claim (real count: 161) is replaced by counts computed from the data files at build time; the static shell texts are now count-free so they cannot go stale.
+* *Normalized snippet lengths* — meta descriptions are capped at ~160 characters on a word boundary; very short anchor extracts get the anchor title prefixed.
+
 == 2026-06-10
 
 *Real anchor pages (#597):*

diff --git a/scripts/prerender-routes.js b/scripts/prerender-routes.js
@@ -218,7 +218,18 @@ const SITE = 'https://llm-coding.github.io/Semantic-Anchors'
  *   enUrl: string, deUrl: (string|null), lang: string}} meta
  * @returns {string} Updated HTML.
  */
+/**
+ * Cap a meta description at ~160 characters on a word boundary — Google
+ * truncates around 160, so longer texts would be cut mid-sentence in SERPs.
+ */
+function capDescription(text) {
+  if (text.length <= 160) return text
+  const cut = text.slice(0, 159)
+  return cut.slice(0, Math.max(cut.lastIndexOf(' '), 100)) + '…'
+}
+
 function applyHead(html, { title, description, canonicalUrl, enUrl, deUrl, lang }) {
+  description = capDescription(description)
   html = html.replace(/<title>[\s\S]*?<\/title>/, `<title>${escapeHtml(title)}</title>`)
 
   html = html.replace(
@@ -246,8 +257,45 @@ function applyHead(html, { title, description, canonicalUrl, enUrl, deUrl, lang
     .join('\n')
   html = html.replace(/(<link\s+rel="canonical"[^>]*>)/, `$1\n${alternates}`)
 
+  // Per-page social metadata (#601): without this every pre-rendered page
+  // keeps the shell's home-pointing og:/twitter: values, so shared subpage
+  // links render the generic home preview.
+  html = html.replace(
+    /<meta\s+property="og:url"\s+content="[^"]*"\s*\/?>/,
+    `<meta property="og:url" content="${canonicalUrl}" />`
+  )
+  html = html.replace(
+    /<meta\s+property="og:title"\s+content="[^"]*"\s*\/?>/,
+    `<meta property="og:title" content="${escapeHtml(title)}" />`
+  )
+  html = html.replace(
+    /<meta\s+property="og:description"\s+content="[^"]*"\s*\/?>/,
+    `<meta property="og:description" content="${escapeHtml(description)}" />`
+  )
+  html = html.replace(
+    /<meta\s+name="twitter:url"\s+content="[^"]*"\s*\/?>/,
+    `<meta name="twitter:url" content="${canonicalUrl}" />`
+  )
+  html = html.replace(
+    /<meta\s+name="twitter:title"\s+content="[^"]*"\s*\/?>/,
+    `<meta name="twitter:title" content="${escapeHtml(title)}" />`
+  )
+  html = html.replace(
+    /<meta\s+name="twitter:description"\s+content="[^"]*"\s*\/?>/,
+    `<meta name="twitter:description" content="${escapeHtml(description)}" />`
+  )
+
   if (lang === 'de') {
     html = html.replace('<html lang="en">', '<html lang="de">')
+    html = html
+      .replace(
+        /<meta\s+property="og:locale"\s+content="[^"]*"\s*\/?>/,
+        '<meta property="og:locale" content="de_DE" />'
+      )
+      .replace(
+        /<meta\s+property="og:locale:alternate"\s+content="[^"]*"\s*\/?>/,
+        '<meta property="og:locale:alternate" content="en_US" />'
+      )
   }
 
   return html
@@ -462,8 +510,12 @@ function prerenderAnchorPages(shell) {
     const hasDe = fs.existsSync(path.join(DIST, fragmentDe))
     const enUrl = `${SITE}/anchor/${anchor.id}`
     const deUrl = hasDe ? `${SITE}/de/anchor/${anchor.id}` : null
+    // Short Core-Concepts extracts ("Dependencies only point inward") get the
+    // anchor title prefixed so the SERP snippet stands on its own (#601).
+    const withTitle = (extracted) =>
+      extracted && extracted.length < 50 ? `${anchor.title} — ${extracted}` : extracted
     const description =
-      extractDescription(`docs/anchors/${anchor.id}.adoc`) ||
+      withTitle(extractDescription(`docs/anchors/${anchor.id}.adoc`)) ||
       `${anchor.title} — a semantic anchor: an established term that activates a rich, well-defined concept in any modern LLM.`
 
     // The anchor body sits in a [%collapsible] block; expand it on the
@@ -494,7 +546,8 @@ function prerenderAnchorPages(shell) {
         fragmentDe,
         {
           title: `${anchor.title} — Semantic Anchors`,
-          description: extractDescription(`docs/anchors/${anchor.id}.de.adoc`) || description,
+          description:
+            withTitle(extractDescription(`docs/anchors/${anchor.id}.de.adoc`)) || description,
           canonicalUrl: deUrl,
           enUrl,
           deUrl,
@@ -530,15 +583,20 @@ function writeHomeVariant(shell, lang) {
       ${buildCatalogMarkup(lang, tr)}
     `
 
+  // Real counts from the data files, so the description can never go stale
+  // again the way the hard-coded "110+" did (#601).
+  const anchorCount = loadWebsiteJson('public/data/anchors.json').length
+  const contractCount = loadWebsiteJson('public/data/contracts.json').length
+
   let html = applyHead(shell, {
     title:
       lang === 'de'
         ? 'Semantic Anchors - Gemeinsames Vokabular für die Kommunikation mit LLMs'
         : 'Semantic Anchors - Shared Vocabulary for LLM Communication',
     description:
       lang === 'de'
-        ? '110+ semantische Anker und semantische Contracts für präzise LLM-Kommunikation. Kuratierte Methoden, Frameworks und komponierbare Projektkonventionen. Über 10 Modelle evaluiert.'
-        : '110+ semantic anchors and semantic contracts for precise LLM communication. Curated methodologies, frameworks, and composable project conventions. Evaluated across 10 models.',
+        ? `${anchorCount} semantische Anker und ${contractCount} semantische Contracts für präzise LLM-Kommunikation — kuratierte Methoden, Frameworks und Projektkonventionen.`
+        : `${anchorCount} semantic anchors and ${contractCount} semantic contracts for precise LLM communication — curated methodologies, frameworks, and composable project conventions.`,
     canonicalUrl: lang === 'de' ? `${SITE}/de/` : `${SITE}/`,
     enUrl: `${SITE}/`,
     deUrl: `${SITE}/de/`,

diff --git a/website/index.html b/website/index.html
@@ -8,7 +8,7 @@
     <!-- Primary Meta Tags -->
     <title>Semantic Anchors - Shared Vocabulary for LLM Communication</title>
     <meta name="title" content="Semantic Anchors - Shared Vocabulary for LLM Communication" />
-    <meta name="description" content="110+ semantic anchors and semantic contracts for precise LLM communication. Curated methodologies, frameworks, and composable project conventions. Evaluated across 10 models." />
+    <meta name="description" content="A curated catalog of semantic anchors and semantic contracts — shared vocabulary for precise communication with Large Language Models." />
     <meta name="keywords" content="semantic anchors, semantic contracts, LLM, large language models, AI communication, prompt engineering, software development, TDD, architecture patterns, design principles, AGENTS.md" />
     <meta name="author" content="LLM Coding Community" />
     <meta name="language" content="English, German" />
@@ -28,7 +28,7 @@
     <meta property="og:type" content="website" />
     <meta property="og:url" content="https://llm-coding.github.io/Semantic-Anchors/" />
     <meta property="og:title" content="Semantic Anchors - Shared Vocabulary for LLM Communication" />
-    <meta property="og:description" content="110+ semantic anchors and semantic contracts for precise LLM communication. Evaluated across 10 models." />
+    <meta property="og:description" content="A curated catalog of semantic anchors and semantic contracts — shared vocabulary for precise communication with Large Language Models." />
     <meta property="og:image" content="https://llm-coding.github.io/Semantic-Anchors/og-image.png" />
     <meta property="og:image:width" content="1200" />
     <meta property="og:image:height" content="630" />
@@ -40,7 +40,7 @@
     <meta name="twitter:card" content="summary_large_image" />
     <meta name="twitter:url" content="https://llm-coding.github.io/Semantic-Anchors/" />
     <meta name="twitter:title" content="Semantic Anchors - Shared Vocabulary for LLM Communication" />
-    <meta name="twitter:description" content="110+ semantic anchors and semantic contracts for precise LLM communication. Evaluated across 10 models." />
+    <meta name="twitter:description" content="A curated catalog of semantic anchors and semantic contracts — shared vocabulary for precise communication with Large Language Models." />
     <meta name="twitter:image" content="https://llm-coding.github.io/Semantic-Anchors/twitter-card.png" />
 
     <!-- Structured Data (Schema.org) -->
@@ -51,7 +51,7 @@
       "name": "Semantic Anchors",
       "alternateName": "Semantic Anchors for LLMs",
       "url": "https://llm-coding.github.io/Semantic-Anchors/",
-      "description": "110+ semantic anchors and semantic contracts for precise communication with Large Language Models. Evaluated across 10 models.",
+      "description": "A curated catalog of semantic anchors and semantic contracts — shared vocabulary for precise communication with Large Language Models.",
       "inLanguage": ["en", "de"],
       "publisher": { "@id": "https://llm-coding.github.io/Semantic-Anchors/#organization" },
       "potentialAction": {

diff --git a/website/src/main.js b/website/src/main.js
@@ -27,7 +27,7 @@ import {
 } from './components/onboarding-modal.js'
 import { renderContractsPage, initContractsPage } from './components/contracts-page.js'
 
-const APP_VERSION = '0.6.0'
+const APP_VERSION = '0.6.1'
 
 window.copyAnchorLink = async function copyAnchorLink(anchorId) {
   const url = `${window.location.origin}${import.meta.env.BASE_URL}anchor/${anchorId}`