zclllyybb commented on issue #3927: URL: https://github.com/apache/doris-website/issues/3927#issuecomment-4679023515
Breakwater-GitHub-Analysis-Slot: slot_b16f5d229dea Initial analysis: This looks like a documentation rendering/navigation issue, not missing source content. I checked the current public issue, the live 4.x Chinese page, and the current `apache/doris-website` upstream `master` source. In the source file `i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/connection-integration/mysql-proto.mdx`, the reported Java/JDBC sections are present under the `Java` tab: - `1. 引入 JDBC 驱动` - `2. 编写连接代码` - `3. 常用 JDBC URL 参数` - `4. 初始化会话变量（可选）` The live rendered page also contains those headings, but they are inside a Docusaurus `TabItem value="java"`, while the default active tab is `MySQL CLI`. The page-level table of contents still exposes headings from the inactive Java tab. When a user clicks those TOC entries while the default `MySQL CLI` tab is active, the anchor points to content inside a hidden tab panel, so the page appears to have missing content. Recommended next step: 1. Treat this as a website/docs navigation bug for tabbed content. 2. For this page, either remove tab-internal `###` headings from the page TOC, for example by setting the page TOC to only include stable top-level headings, or restructure the tab content so hidden-tab headings are not collected by the global TOC. 3. If a site-wide fix is preferred, add custom tab/anchor handling so navigating to an anchor inside a `TabItem` activates the owning tab, or filter the TOC to only include currently visible tab content. 4. Validate both Chinese and English 4.x pages, since the English 4.x source has the same tab/heading structure. Useful confirmation steps after a fix: - Open `/zh-CN/docs/4.x/connection-integration/mysql-proto/`. - Click the TOC entries for `1. 引入 JDBC 驱动`, `2. 编写连接代码`, `3. 常用 JDBC URL 参数`, and `4. 初始化会话变量（可选）`. - Confirm the corresponding Java tab content is visible, not hidden behind the default `MySQL CLI` tab. Missing information from the report is only the browser/device details. The current source and live HTML are already sufficient to reproduce the apparent missing-content behavior. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
