This is an automated email from the ASF dual-hosted git repository.
morningman pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris-website.git
The following commit(s) were added to refs/heads/master by this push:
new 3b31938b64bc [docs] Hide inactive client-tab headings from MySQL guide
TOC (#4623)
3b31938b64bc is described below
commit 3b31938b64bc77a1924c5356ee7a452337b4533e
Author: Mingyu Chen (Rayner) <[email protected]>
AuthorDate: Fri Nov 13 08:03:43 2026 +0800
[docs] Hide inactive client-tab headings from MySQL guide TOC (#4623)
Limit the MySQL protocol guide table of contents to its always-visible
level-two headings. Java/JDBC instructions remain available in the Java
tab; hidden tab-specific headings no longer appear as links that seem to
lead to missing content. Existing heading anchors remain unchanged.
Fixes #3927
Versions and languages: dev and 4.x, English and Chinese; 3.x has no
matching page.
Source verification:
- All reported Java/JDBC sections exist inside TabItem value=java;
default selected tab is mysql-cli
- Desktop and mobile DocItem TOC components pass
frontMatter.toc_max_heading_level into the TOC renderer
- Docusaurus filterTOC filters headings by min/max level; all
tab-specific headings on these pages are level3
Validation:
- Confirmed each level-two heading is outside all TabItem panels and
each tab-specific heading is level3
- Verified page paths, heading text and existing anchors remain
unchanged
- Checked metadata behavior against desktop/mobile theme code and
Docusaurus TOC filtering
- git diff --check
Review:
- Goal: correct the reported documentation issue; the changed content
directly addresses it.
- Scope: targeted documentation edits.
- Information architecture: active version and locale counterparts
inspected; archived snapshots unchanged.
- Navigation: no paths, slugs, anchors or sidebar entries changed.
- Frontend/build: no framework, styling or build-script changes.
- Validation limits: no live Doris execution or full website build
performed.
- Other concerns: The change narrows desktop/mobile TOC entries for this
page only. Tab content and existing direct anchors remain intact; no
global theme changes.
Co-authored-by: morningman <[email protected]>
---
docs/connection-integration/mysql-proto.mdx | 1 +
.../current/connection-integration/mysql-proto.mdx | 1 +
.../version-4.x/connection-integration/mysql-proto.mdx | 1 +
versioned_docs/version-4.x/connection-integration/mysql-proto.mdx | 1 +
4 files changed, 4 insertions(+)
diff --git a/docs/connection-integration/mysql-proto.mdx
b/docs/connection-integration/mysql-proto.mdx
index 6139ae0d2c19..67d86eaea8d9 100644
--- a/docs/connection-integration/mysql-proto.mdx
+++ b/docs/connection-integration/mysql-proto.mdx
@@ -1,6 +1,7 @@
---
{
"title": "Connecting via MySQL Protocol",
+ "toc_max_heading_level": 2,
"language": "en",
"description": "Introduces Apache Doris's compatibility with the MySQL
network protocol, and provides connection examples for the MySQL CLI and
mainstream languages such as Java, Go, Rust, Python, and C++."
}
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/connection-integration/mysql-proto.mdx
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/connection-integration/mysql-proto.mdx
index f1ac8ad0c5ed..ffd299e7a051 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/connection-integration/mysql-proto.mdx
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/connection-integration/mysql-proto.mdx
@@ -1,6 +1,7 @@
---
{
"title": "通过 MySQL 协议连接",
+ "toc_max_heading_level": 2,
"language": "zh-CN",
"description": "介绍 Apache Doris 兼容 MySQL 网络协议的能力，并提供 MySQL CLI 与
Java、Go、Rust、Python、C++ 等主流语言的连接示例。"
}
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/connection-integration/mysql-proto.mdx
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/connection-integration/mysql-proto.mdx
index f1ac8ad0c5ed..ffd299e7a051 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/connection-integration/mysql-proto.mdx
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/connection-integration/mysql-proto.mdx
@@ -1,6 +1,7 @@
---
{
"title": "通过 MySQL 协议连接",
+ "toc_max_heading_level": 2,
"language": "zh-CN",
"description": "介绍 Apache Doris 兼容 MySQL 网络协议的能力，并提供 MySQL CLI 与
Java、Go、Rust、Python、C++ 等主流语言的连接示例。"
}
diff --git a/versioned_docs/version-4.x/connection-integration/mysql-proto.mdx
b/versioned_docs/version-4.x/connection-integration/mysql-proto.mdx
index 6139ae0d2c19..67d86eaea8d9 100644
--- a/versioned_docs/version-4.x/connection-integration/mysql-proto.mdx
+++ b/versioned_docs/version-4.x/connection-integration/mysql-proto.mdx
@@ -1,6 +1,7 @@
---
{
"title": "Connecting via MySQL Protocol",
+ "toc_max_heading_level": 2,
"language": "en",
"description": "Introduces Apache Doris's compatibility with the MySQL
network protocol, and provides connection examples for the MySQL CLI and
mainstream languages such as Java, Go, Rust, Python, and C++."
}
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
