From 4740f20174a46ea52f9377749c085f83885c08ce Mon Sep 17 00:00:00 2001
From: "serge.klochkov" <serge.klochkov@clickhouse.com>
Date: Wed, 17 Sep 2025 13:09:09 +0200
Subject: [PATCH] Allow configuring onBrokenAnchors for Docusaurus, add a
 README note

---
 README.md               | 4 ++++
 docusaurus.config.en.js | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 214fb7c4c47..85e9a794941 100644
--- a/README.md
+++ b/README.md
@@ -80,6 +80,10 @@ You can run a copy of this website locally within a few steps. Some folks find t
     # [INFO] Use `npm run serve` command to test your build locally.
     # ✨  Done in 105.96s.
     ```
+   
+> [!TIP]
+> If the build command is failing due to broken anchors, 
+> it is possible to ignore these temporarily by running `ON_BROKEN_ANCHORS=ignore yarn build` instead.
 
 1. Start the local web-server:
 
diff --git a/docusaurus.config.en.js b/docusaurus.config.en.js
index ee13b6df1cc..125244df775 100644
--- a/docusaurus.config.en.js
+++ b/docusaurus.config.en.js
@@ -57,7 +57,7 @@ const config = {
   onBrokenLinks: "throw",
   onBrokenMarkdownLinks: "warn",
   onDuplicateRoutes: "throw",
-  onBrokenAnchors: "throw",
+  onBrokenAnchors: process.env.ON_BROKEN_ANCHORS ?? "throw",
   favicon: "img/docs_favicon.ico",
   organizationName: "ClickHouse",
   trailingSlash: false,