Skip to content

Unlist replica-aware routing docs page from nav and search (DOC-849)#6435

Merged
dhtclk merged 1 commit into
mainfrom
doc-849-unlist-replica-aware-routing-docs-page-from-nav-and-search
Jun 23, 2026
Merged

Unlist replica-aware routing docs page from nav and search (DOC-849)#6435
dhtclk merged 1 commit into
mainfrom
doc-849-unlist-replica-aware-routing-docs-page-from-nav-and-search

Conversation

@dhtclk

@dhtclk dhtclk commented Jun 23, 2026

Copy link
Copy Markdown
Collaborator

Retires the replica-aware routing page without deleting it — some users are still on the feature, so it stays reachable by direct URL while being removed from navigation and search.

DOC-849

Changes

  • docs/cloud/features/05_infrastructure/replica-aware-routing.md — add unlisted: true. Docusaurus drops it from the autogenerated sidebar, excludes it from the sitemap, and tags it noindex. The page is still served at /manage/replica-aware-routing.
  • scripts/search/index_pages.py — teach the Algolia indexer to read and skip unlisted/draft pages. It previously ignored these flags, so unlisted pages were still indexed and surfaced in site search.

Note for reviewers

The indexer change is repo-wide by design: it now correctly excludes all 8 currently-unlisted pages (this one, the AI model-parameters page, and 6 managed-onboarding pages) — 65 search records that were being indexed despite unlisted: true. Verified locally with index_pages.py --dry_run: the replica-aware routing page went from 5 records to 0, total index 22,426 → 22,361.

The update search label is applied so the index is refreshed on merge.

Not covered here

kapa.ai ("Ask AI") is a separate ingestion pipeline managed outside this repo and is unaffected by these changes. If the page should also be excluded from AI answers, that needs a URL exclusion in the kapa dashboard — tracked as a follow-up on DOC-849.

🤖 Generated with Claude Code

Add `unlisted: true` to the replica-aware routing page so it drops from the autogenerated sidebar, the sitemap, and is tagged noindex, while staying reachable by direct URL.

Teach the Algolia indexer (scripts/search/index_pages.py) to read and skip pages with `unlisted`/`draft` set in frontmatter. The indexer previously ignored these flags, so unlisted pages were still surfaced in site search. This removes the replica-aware routing page (and 7 other already-unlisted pages that were being indexed by mistake).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@dhtclk dhtclk requested a review from a team as a code owner June 23, 2026 19:05
@vercel

vercel Bot commented Jun 23, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
clickhouse-docs Ready Ready Preview, Comment Jun 23, 2026 7:17pm
clickhouse-docs-jp Building Building Preview, Comment Jun 23, 2026 7:17pm
3 Skipped Deployments
Project Deployment Actions Updated (UTC)
clickhouse-docs-ko Ignored Ignored Preview Jun 23, 2026 7:17pm
clickhouse-docs-ru Ignored Ignored Preview Jun 23, 2026 7:17pm
clickhouse-docs-zh Ignored Ignored Preview Jun 23, 2026 7:17pm

Request Review

@dhtclk dhtclk merged commit f9e0628 into main Jun 23, 2026
17 checks passed
@mintlify

mintlify Bot commented Jun 23, 2026

Copy link
Copy Markdown

Docs PR opened: ClickHouse/mintlify-docs-dev#250

Removed the replica-aware routing page from Cloud navigation and excluded it from search while keeping it reachable by URL.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants