From 866c638f18170a8bcb66df55dfa96cb7040489cc Mon Sep 17 00:00:00 2001
From: Lenny Chen <lenny.chen@temporal.io>
Date: Mon, 6 Jul 2026 14:12:32 -0700
Subject: [PATCH] Fix Vale flagging MDX custom heading-ID comments as prose

Headings like '## Highly available Worker patterns {/* #ha-worker-patterns */}'
were being scanned as prose, so kebab-case anchor slugs (e.g.
'ha-worker-patterns') tripped Temporal.terms whenever they happened to
contain a lowercase Temporal term substring. This pattern is used in
315 files. Add a TokenIgnores rule to exclude MDX comment syntax
({/* ... */}) from both Temporal rules.
---
 .vale-ci.ini               | 3 +++
 vale/test/headings-good.md | 2 ++
 vale/test/terms-bad.md     | 2 ++
 3 files changed, 7 insertions(+)

diff --git a/.vale-ci.ini b/.vale-ci.ini
index 0ecef14e79..7ee2572aed 100644
--- a/.vale-ci.ini
+++ b/.vale-ci.ini
@@ -11,5 +11,8 @@ Temporal.complexwords = NO
 Temporal.programming = NO
 Temporal.WordList = NO
 
+; ignore MDX custom heading-ID comments, e.g. {/* #ha-worker-patterns */}
+TokenIgnores = (\{/\*[^\n]*?\*/\})
+
 [formats]
 mdx = md
diff --git a/vale/test/headings-good.md b/vale/test/headings-good.md
index bfe491b49a..59543cd477 100644
--- a/vale/test/headings-good.md
+++ b/vale/test/headings-good.md
@@ -41,3 +41,5 @@
 ## Update a running Workflow
 
 ## Durable External Storage for large payloads
+
+## Highly available Worker patterns {/* #ha-worker-patterns */}
diff --git a/vale/test/terms-bad.md b/vale/test/terms-bad.md
index 23450c994a..4dbadd1d62 100644
--- a/vale/test/terms-bad.md
+++ b/vale/test/terms-bad.md
@@ -27,3 +27,5 @@ Use heartbeating to report activity progress.
 The codec server provides remote payload encoding.
 
 A child workflow execution inherits the parent close policy.
+
+## Highly available worker patterns {/* #ha-worker-patterns */}