From dad9b09c94509611dd2d228818d219dbe5212b9d Mon Sep 17 00:00:00 2001
From: sebastien <lorber.sebastien@gmail.com>
Date: Thu, 26 Mar 2026 17:39:04 +0100
Subject: [PATCH] disable comments compat on our site

---
 .../tests/links/test-markdown-links.mdx       |  2 --
 .../_pages tests/markdown-tests-mdx.mdx       | 23 ++++++++-----------
 website/docusaurus.config.ts                  |  2 +-
 3 files changed, 10 insertions(+), 17 deletions(-)

diff --git a/website/_dogfooding/_docs tests/tests/links/test-markdown-links.mdx b/website/_dogfooding/_docs tests/tests/links/test-markdown-links.mdx
index e2ddf64da893..3e3d03d7e217 100644
--- a/website/_dogfooding/_docs tests/tests/links/test-markdown-links.mdx	
+++ b/website/_dogfooding/_docs tests/tests/links/test-markdown-links.mdx	
@@ -65,8 +65,6 @@ MDX/HTML comments with invalid file references should not be resolved nor report
 
 {/* [doesNotExist.mdx](doesNotExist.mdx) */}
 
-<!-- [doesNotExist.mdx](doesNotExist.mdx) -->
-
 ## Reference-style links
 
 The following should also work:
diff --git a/website/_dogfooding/_pages tests/markdown-tests-mdx.mdx b/website/_dogfooding/_pages tests/markdown-tests-mdx.mdx
index 766c45ce57f7..1adab642b270 100644
--- a/website/_dogfooding/_pages tests/markdown-tests-mdx.mdx	
+++ b/website/_dogfooding/_pages tests/markdown-tests-mdx.mdx	
@@ -50,23 +50,18 @@ import TabItem from '@theme/TabItem';
 
 ## Comments
 
-Html comment: <!-- comment -->
-
-Html comment multi-line:
-
-<!--
-comment
--->
-
-<!-- prettier-ignore -->
 MDX comment: {/* comment */}
 
-MDX comment multi-line:
+MDX comment in JSX:
 
-<!-- prettier-ignore -->
-{/*
-comment
-*/}
+<>
+  {/* comment */}
+  <span>
+    {/* comment */}
+    TEST
+    {/* comment */}
+  </span>
+</>
 
 ## Import code block from source code file
 
diff --git a/website/docusaurus.config.ts b/website/docusaurus.config.ts
index 7f541c1caf52..e0477b74bc17 100644
--- a/website/docusaurus.config.ts
+++ b/website/docusaurus.config.ts
@@ -235,7 +235,7 @@ export default async function createConfigAsync() {
       },
       mdx1Compat: {
         headingIds: false,
-        // comments: false,
+        comments: false,
       },
       remarkRehypeOptions: {
         footnoteLabel: getLocalizedConfigValue('remarkRehypeOptions_footnotes'),