[fix](doc) update broken external and internal links#3720
Merged
Conversation
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Repointing references that 404 today, plus three broken card links inside
table-design/overview.mdx.External links that now 404
lakehouse/catalogs/jdbc-catalog-overview.mddoris.apache.org/community/how-to-contribute/jdbc-catalog-developer-guidedoris.apache.org/community/developer-guide/data-source-extension/jdbc-catalog-developer-guidelakehouse/lakehouse-overview.md,catalogs/kudu-catalog.md,kafka-catalog.md,bigquery-catalog.md,delta-lake-catalog.md,best-practices/tpch.md,best-practices/tpcds.mddoris.apache.org/community/how-to-contribute/trino-connector-developer-guidedoris.apache.org/community/developer-guide/data-source-extension/trino-connector-developer-guideadmin-manual/cluster-management/upgrade.mddoris.apache.org/community/release-versioningdoris.apache.org/community/release-and-verify/release-versioninginstall/deploy-on-kubernetes/.../install-config-cluster.md(comment in abe.confexample)github.com/apache/doris/blob/master/docs/zh-CN/community/developer-guide/debug-tool.md#jemalloc-heap-profiledoris.apache.org/community/developer-guide/debug-tool#jemalloc-heap-profilelakehouse/file-formats/lance.mdlancedb.github.io/lance/docs.lancedb.com/lancekey-features/data-lineage.mdxopenlineage.io/docs/spec/overview/openlineage.io/docs/spec/object-modelsql-manual/.../CREATE-CATALOG.md,CREATE-RESOURCE.mddoris-community-test-1308700295.cos.ap-hongkong.myqcloud.com/jdbc_driver/mysql-connector-java-8.0.25.jarrepo1.maven.org/maven2/mysql/mysql-connector-java/8.0.25/mysql-connector-java-8.0.25.jarAll replacement URLs were verified to return HTTP 200.
The Tencent COS bucket
doris-community-test-1308700295.cos.ap-hongkongis decommissioned (returns 404). The Maven Central artifact is the same file. The unrelatedselectdb-doris-1308700295.cos.ap-beijingbucket referenced fromauth/authorization/ranger.mdis still live and was left unchanged.Broken card links in
table-design/overview.mdxoverview.mdxhas three<GettingStartedCard link="..."/>targets that don't resolve:./data-partitioning/data-distribution—data-distribution.mdwas removed in 4.x. The sidebar's "Partitioning & Bucketing" category now lands onbasic-concepts, so the card now points to./data-partitioning/basic-concepts(the page that explains the same concept).../ai/vector-search/hnsw— there is noai/vector-searchtree. The HNSW page lives attable-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 atdata-model/tips.md, so the link is now./data-model/tips.Scope
Changes applied to
docs/, the matching pages inversioned_docs/version-{2.1,3.x,4.x}/, and the correspondingi18n/zh-CN/files where each URL is actually present (some Chinese files don't reference the URL and were not touched).Test plan
basic-concepts.mdx,index/vector-index/hnsw.md,data-model/tips.md) exist as files in this branch.