diff --git a/docs/content/_index.md b/docs/content/_index.md
index 9d5ee03..516f58a 100644
--- a/docs/content/_index.md
+++ b/docs/content/_index.md
@@ -1,6 +1,6 @@
 ---
 title: "typescript-as-data"
-description: "Configuration as code, parsed as data."
+description: "A specification for building JSON and YAML compilers from TypeScript."
 ---
 
 ## A policy in YAML and in TypeScript
diff --git a/docs/content/spec/_index.md b/docs/content/spec/_index.md
index 9c033de..66d71a8 100644
--- a/docs/content/spec/_index.md
+++ b/docs/content/spec/_index.md
@@ -1,6 +1,6 @@
 ---
 title: "The specification"
-description: "The normative text, the reference implementation that implements it, the conformance suite that judges an implementation, and the evidence behind every figure."
+description: "A specification for building JSON and YAML compilers from TypeScript, with the reference implementation, the conformance suite that judges an implementation, and the evidence behind every figure."
 weight: 40
 aliases: ["/introduction/"]
 ---
diff --git a/docs/hugo.toml b/docs/hugo.toml
index 3648cdc..8f91a2f 100644
--- a/docs/hugo.toml
+++ b/docs/hugo.toml
@@ -5,7 +5,7 @@ disableKinds = ["taxonomy", "term"]
 
 [params]
   repo = "https://github.com/INTENTIUS/typescript-as-data"
-  description = "Configuration as code, parsed as data."
+  description = "A specification for building JSON and YAML compilers from TypeScript."
 
 # The header's fixed entries. Consumers are not listed here: the header
 # renders a "For your platform" menu from data/consumers.yaml, so a new
diff --git a/paper/draft.md b/paper/draft.md
index cbe5d0c..5f58d11 100644
--- a/paper/draft.md
+++ b/paper/draft.md
@@ -1,5 +1,5 @@
 ---
-title: "Configuration as code, parsed as data: a statically evaluable subset of TypeScript with a specified fallback"
+title: "TypeScript as data: a specification for building JSON and YAML compilers, with a specified fallback"
 author: "INTENTIUS"
 date: "Extended draft for comment, September 2026"
 ---