diff --git a/web/scripts/lint-docs.mjs b/web/scripts/lint-docs.mjs
index 81480ad..ec86e78 100644
--- a/web/scripts/lint-docs.mjs
+++ b/web/scripts/lint-docs.mjs
@@ -92,6 +92,10 @@ function checkFile(file, raw) {
             continue;
         }
 
+        // Inline code may deliberately name an authoring marker, as migration guidance
+        // does with `TODO(cratis-codemod)`. Only prose should trigger marker errors.
+        const prose = line.replace(/`[^`]*`/g, '');
+
         // Errors
         for (const re of NONDESCRIPTIVE) {
             if (re.test(line)) { console.error(`  [link-text] ${at}  ${line.trim()}`); errors++; }
@@ -100,11 +104,10 @@ function checkFile(file, raw) {
             if (re.test(line)) { console.error(`  [docfx] ${at}  ${line.trim()}`); errors++; }
         }
         for (const re of AUTHORING_MARKERS) {
-            if (re.test(line)) { console.error(`  [marker] ${at}  ${line.trim()}`); errors++; }
+            if (re.test(prose)) { console.error(`  [marker] ${at}  ${line.trim()}`); errors++; }
         }
 
         // Warnings (style guide) — skip inline-code spans so `simply` in `code` is ignored.
-        const prose = line.replace(/`[^`]*`/g, '');
         // Heading end-punctuation: check the original line (entities decoded), NOT the
         // code-stripped `prose`. A heading like `## Convenience: `[EventLog]`` ends in a
         // code span, not punctuation — stripping the code first would leave a phantom
diff --git a/web/src/content/docs/compare-event-sourcing-dotnet.mdx b/web/src/content/docs/compare-event-sourcing-dotnet.mdx
index 465b416..6dfe60f 100644
--- a/web/src/content/docs/compare-event-sourcing-dotnet.mdx
+++ b/web/src/content/docs/compare-event-sourcing-dotnet.mdx
@@ -1,6 +1,11 @@
 ---
 title: "Event sourcing in .NET: KurrentDB, Marten, and Cratis Chronicle"
 description: "Compare KurrentDB 26.0, Marten 9.30.0, and Cratis Chronicle 16.42.0 for .NET event sourcing, with versioned sources and architectural trade-offs."
+head:
+  - tag: meta
+    attrs:
+      name: keywords
+      content: "event sourcing .NET comparison, event sourcing C#, .NET event store comparison, KurrentDB vs Marten vs Cratis Chronicle, Marten vs Cratis Chronicle, EventStoreDB alternatives, KurrentDB alternatives, choosing an event sourcing framework for .NET, event sourcing database .NET"
 ---
 
 import { Aside } from '@astrojs/starlight/components';
diff --git a/web/src/content/docs/compare-event-sourcing-jvm.mdx b/web/src/content/docs/compare-event-sourcing-jvm.mdx
index 03860dd..bfabcaf 100644
--- a/web/src/content/docs/compare-event-sourcing-jvm.mdx
+++ b/web/src/content/docs/compare-event-sourcing-jvm.mdx
@@ -1,6 +1,11 @@
 ---
 title: "Event sourcing on the JVM: Axon, KurrentDB, and Cratis Chronicle"
 description: "Compare Axon Framework 5.3.1, KurrentDB 26.0, and Cratis Chronicle 16.42.0 for Java and Kotlin event sourcing, with versioned sources and trade-offs."
+head:
+  - tag: meta
+    attrs:
+      name: keywords
+      content: "event sourcing JVM comparison, event sourcing Kotlin, event sourcing Java, Axon Framework vs KurrentDB vs Cratis Chronicle, Axon Framework alternatives, event store Java comparison, Kotlin event sourcing framework, Spring Boot event sourcing, choosing an event sourcing framework for the JVM, event sourcing database Java"
 ---
 
 import { Aside } from '@astrojs/starlight/components';