Fix broken anchor fragments in settings and function links#6278
Open
Blargian wants to merge 1 commit into
Open
Fix broken anchor fragments in settings and function links#6278Blargian wants to merge 1 commit into
Blargian wants to merge 1 commit into
Conversation
Several links across docs/ and knowledgebase/ used anchor fragments that
never existed on the target heading. The Docusaurus-namespaced prefixes
(server_configuration_parameters-X, settings-X) were never valid IDs;
some settings anchors were also written with hyphens where the actual
ID uses underscores; a couple of function anchors used the wrong case.
Surfaced by a broken-link sweep of the upcoming Mintlify-rendered docs;
each anchor below was verified against the target heading's {#id}.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
@Blargian is attempting to deploy a commit to the ClickHouse Team on Vercel. A member of the Team first needs to authorize it. |
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
A broken-link sweep of the upcoming Mintlify-rendered docs surfaced ~30 link fragments that point at anchors that never existed on the target heading. All of them are author typos in source content (verified against each target heading's explicit
{#id}ID); none are caused by Docusaurus → Mintlify slugifier divergence.Three patterns are involved:
#server_configuration_parameters-user_files_path,#server_configuration_parameters-logger,#server_configuration_parameters-openssl,#server_configuration_parameters-query-log, and#settings-max_threads/#settings-max_insert_block_size. The corresponding target headings are plain## user_files_path {#user_files_path},## logger {#logger},## openSSL {#openssl},## query_log {#query_log},## max_threads {#max_threads},## max_insert_block_size {#max_insert_block_size}.#parts-to-delay-insert,#parts-to-throw-insert,#min-insert-block-size-rows,#min-insert-block-size-bytes,#max-thread-pool-size. The actual heading IDs are underscore form (#parts_to_delay_insert, etc.).#cityhash64→#cityHash64; the malformed#arraymapfunc-arr1-→#arrayMap.Files changed
docs/guides/best-practices/sparse-primary-indexes.mddocs/guides/sre/tls/configuring-tls.mddocs/integrations/language-clients/rust.mdknowledgebase/Insert_select_settings_tuning.mdxknowledgebase/async_vs_optimize_read_in_order.mdxknowledgebase/compare_resultsets.mdxknowledgebase/finding_expensive_queries_by_memory_usage.mdxknowledgebase/how-to-increase-thread-pool-size.mdxknowledgebase/importing-geojason-with-nested-object-array.mdxTest plan
{#id}on the linked target page (verified by grep againstdocs/operations/settings/*.md,docs/operations/server-configuration-parameters/settings.md,docs/sql-reference/functions/hash-functions.md,docs/sql-reference/functions/array-functions.md).docs/orknowledgebase/(broad grep, see commit message).🤖 Generated with Claude Code
Note
Low Risk
Documentation-only link fragment fixes with no runtime or configuration behavior changes.
Overview
This PR fixes broken in-page link anchors across guides, integrations, and knowledge base articles so they match the real
{#id}values on target docs (for Mintlify and post-migration link checks).Anchor corrections fall into three patterns: removing obsolete Docusaurus-style prefixes (e.g.
#server_configuration_parameters-user_files_path→#user_files_path,#settings-max_threads→#max_threads); using underscores where settings IDs use them (e.g.#parts-to-delay-insert→#parts_to_delay_insert); and fixing function anchor casing (e.g.#cityhash64→#cityHash64, malformed#arraymapfunc-arr1-→#arrayMap).Touched paths include the sparse primary index guide, TLS configuration guide, Rust client docs, and several knowledge base articles (insert/select tuning, async read, result-set comparison, query log, thread pool, GeoJSON import).
Reviewed by Cursor Bugbot for commit 19b50fd. Bugbot is set up for automated code reviews on this repo. Configure here.