Skip to content

[fix](doc) update broken external and internal links#3720

Merged
morningman merged 2 commits into
apache:masterfrom
boluor:fix-batch32-dead-links
May 22, 2026
Merged

[fix](doc) update broken external and internal links#3720
morningman merged 2 commits into
apache:masterfrom
boluor:fix-batch32-dead-links

Conversation

@boluor
Copy link
Copy Markdown
Contributor

@boluor boluor commented May 21, 2026

Summary

Repointing references that 404 today, plus three broken card links inside table-design/overview.mdx.

External links that now 404

Where Old URL New URL
lakehouse/catalogs/jdbc-catalog-overview.md doris.apache.org/community/how-to-contribute/jdbc-catalog-developer-guide doris.apache.org/community/developer-guide/data-source-extension/jdbc-catalog-developer-guide
lakehouse/lakehouse-overview.md, catalogs/kudu-catalog.md, kafka-catalog.md, bigquery-catalog.md, delta-lake-catalog.md, best-practices/tpch.md, best-practices/tpcds.md doris.apache.org/community/how-to-contribute/trino-connector-developer-guide doris.apache.org/community/developer-guide/data-source-extension/trino-connector-developer-guide
admin-manual/cluster-management/upgrade.md doris.apache.org/community/release-versioning doris.apache.org/community/release-and-verify/release-versioning
install/deploy-on-kubernetes/.../install-config-cluster.md (comment in a be.conf example) github.com/apache/doris/blob/master/docs/zh-CN/community/developer-guide/debug-tool.md#jemalloc-heap-profile doris.apache.org/community/developer-guide/debug-tool#jemalloc-heap-profile
lakehouse/file-formats/lance.md lancedb.github.io/lance/ docs.lancedb.com/lance
key-features/data-lineage.mdx openlineage.io/docs/spec/overview/ openlineage.io/docs/spec/object-model
sql-manual/.../CREATE-CATALOG.md, CREATE-RESOURCE.md doris-community-test-1308700295.cos.ap-hongkong.myqcloud.com/jdbc_driver/mysql-connector-java-8.0.25.jar repo1.maven.org/maven2/mysql/mysql-connector-java/8.0.25/mysql-connector-java-8.0.25.jar

All replacement URLs were verified to return HTTP 200.

The Tencent COS bucket doris-community-test-1308700295.cos.ap-hongkong is decommissioned (returns 404). The Maven Central artifact is the same file. The unrelated selectdb-doris-1308700295.cos.ap-beijing bucket referenced from auth/authorization/ranger.md is still live and was left unchanged.

Broken card links in table-design/overview.mdx

overview.mdx has three <GettingStartedCard link="..."/> targets that don't resolve:

  • ./data-partitioning/data-distributiondata-distribution.md was removed in 4.x. The sidebar's "Partitioning & Bucketing" category now lands on basic-concepts, so the card now points to ./data-partitioning/basic-concepts (the page that explains the same concept).
  • ../ai/vector-search/hnsw — there is no ai/vector-search tree. The HNSW page lives at table-design/index/vector-index/hnsw.md, so the link is now ./index/vector-index/hnsw.
  • ./best-practice — no such page exists. The content titled "Table Model Best Practices" lives at data-model/tips.md, so the link is now ./data-model/tips.

Scope

Changes applied to docs/, the matching pages in versioned_docs/version-{2.1,3.x,4.x}/, and the corresponding i18n/zh-CN/ files where each URL is actually present (some Chinese files don't reference the URL and were not touched).

Test plan

  • Each replacement URL fetched and confirmed HTTP 200 (or, for the Maven artifact, HEAD 200).
  • Sanity-checked that the new internal link targets (basic-concepts.mdx, index/vector-index/hnsw.md, data-model/tips.md) exist as files in this branch.
  • CI build (docusaurus + link check).

External link updates
- doris.apache.org/community/how-to-contribute/jdbc-catalog-developer-guide → community/developer-guide/data-source-extension/jdbc-catalog-developer-guide
- doris.apache.org/community/how-to-contribute/trino-connector-developer-guide → community/developer-guide/data-source-extension/trino-connector-developer-guide
- doris.apache.org/community/release-versioning → community/release-and-verify/release-versioning
- github.com/apache/doris/blob/master/docs/zh-CN/community/developer-guide/debug-tool.md → doris.apache.org/community/developer-guide/debug-tool (old apache/doris path no longer exists; content lives in this website's community section)
- lancedb.github.io/lance/ → docs.lancedb.com/lance (Lance documentation moved to docs.lancedb.com)
- openlineage.io/docs/spec/overview/ → openlineage.io/docs/spec/object-model (the old spec/overview route was removed; object-model is the new spec landing)
- doris-community-test-1308700295.cos.ap-hongkong.myqcloud.com/jdbc_driver/mysql-connector-java-8.0.25.jar → repo1.maven.org/maven2/mysql/mysql-connector-java/8.0.25/mysql-connector-java-8.0.25.jar (Tencent COS bucket was decommissioned; switch to Maven Central)

Internal link updates in table-design/overview.mdx
- ./data-partitioning/data-distribution → ./data-partitioning/basic-concepts (data-distribution.md was removed in 4.x; basic-concepts is now the conceptual overview that Partitioning & Bucketing sidebar category lands on)
- ../ai/vector-search/hnsw → ./index/vector-index/hnsw (vector index lives under table-design/index/vector-index, not under a top-level ai/ tree)
- ./best-practice → ./data-model/tips (the page titled "Table Model Best Practices" lives at data-model/tips.md)

Applied across docs/, versioned_docs/{2.1,3.x,4.x}/, and i18n/zh-CN/ where the affected URL is present.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
CI surfaced a pre-existing broken relative link in `CREATE-RESOURCE.md` once the file was modified by the surrounding bucket-URL fix. The link points at `../../../../lakehouse/datalake-analytics/hive`, a path that does not exist in 2.1 or 3.x (those versions have the file under `lakehouse/catalogs/hive-catalog.mdx`, which is also what 4.x and current already use). Repoint to the canonical path so the dead-link checker is satisfied.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@morningman morningman merged commit bd5925b into apache:master May 22, 2026
3 checks passed
@boluor boluor deleted the fix-batch32-dead-links branch May 22, 2026 08:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants