From a3642b24a501f2fee2a96eb60cce2d105634e031 Mon Sep 17 00:00:00 2001 From: scttbnsn <80784472+scttbnsn@users.noreply.github.com> Date: Mon, 15 Jun 2026 08:19:48 -0400 Subject: [PATCH] =?UTF-8?q?=F0=9F=90=9B=20fix(docs):=20strip=20HTML=20comm?= =?UTF-8?q?ents=20from=20generated=20changelog=20MDX?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit sync-docs.mjs copied CHANGELOG.md verbatim into the fumadocs MDX source. The maintainer note in the [Unreleased] section is valid in the GitHub-rendered CHANGELOG but MDX v3 rejects HTML comments, failing the Turbopack build (drydock-website production + preview deploys erroring since 2026-06-13). Strip HTML comments during generation (they are not published-docs content) and collapse the resulting blank-line gap. CHANGELOG.md stays GitHub-valid and unchanged. --- apps/web/scripts/sync-docs.mjs | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/apps/web/scripts/sync-docs.mjs b/apps/web/scripts/sync-docs.mjs index 582986cf3..c26be223d 100644 --- a/apps/web/scripts/sync-docs.mjs +++ b/apps/web/scripts/sync-docs.mjs @@ -27,7 +27,15 @@ title: "Changelog" description: "All notable changes to this project will be documented in this file." ---`; -const body = changelogMd.replace(/^# Changelog\n/, ""); +// Strip HTML comments () before emitting MDX. They are valid in the +// GitHub-rendered CHANGELOG (used for maintainer-only notes) but MDX v3 rejects +// them ("use {/* */}"), which fails the fumadocs/Turbopack build. They are not +// published-docs content, so drop them, then collapse the blank-line gap left +// behind so the generated MDX stays tidy. +const body = changelogMd + .replace(/^# Changelog\n/, "") + .replace(//g, "") + .replace(/\n{3,}/g, "\n\n"); // Write changelog into the current (v1.5) source dir so it gets copied const changelogDir = join(repoRoot, "content", "docs", "current", "changelog");