The old single-page Swagger view exposed #tag/<Tag>/operation/<id>
anchors; the generated per-endpoint pages do not, so links that kept
those anchors after the namespace move all landed on the "Get list of
available organizations" page. Point every such link at the generated
per-endpoint slug instead. Tag-level links (Billing, ClickStack,
ClickPipes, Postgres) now target the first endpoint page of their
sidebar group. The removed operationId postgresServiceSetConfig maps to
postgresInstanceConfigPost, matching the POST /config example the doc
shows. All target slugs verified live on the Mintlify preview. Locale
copies follow via the translation pipeline.
Addresses https://github.com/ClickHouse/ClickHouse/pull/109890#discussion_r3563969087
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Moving the Cloud API reference to `products/cloud/api-reference` left the
old `/api-reference/...` operation URLs without redirects while many
pages still linked them. Since every operation page is generated from
the same spec, the old slugs map 1:1 onto the new namespace: add a
single wildcard redirect `/api-reference/:path*` ->
`/products/cloud/api-reference/:path*` and rewrite the hard-coded links
in the English docs (13 files, both inline and reference-style links).
Locale copies are left to the translation pipeline. The one remaining
`api-reference/embeddings` match is part of an external OpenAI URL and
is untouched.
Addresses https://github.com/ClickHouse/ClickHouse/pull/109890#discussion_r3561434601
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The `docs/images` tree is ~218 MB, dominated by ~2,000 screenshots. The PNGs
were already losslessly optimized (oxipng finds no further gains), so the only
lossless lever left is a more efficient container. AVIF is unsupported by
Mintlify, so convert static PNGs to lossless WebP (pixel-identical, universally
supported).
Encoded each PNG with `cwebp -lossless -q 100 -m 6`, keeping the WebP only when
it is smaller than the source (19 PNGs where WebP was larger are left as-is),
and rewrote every reference across English and all locale pages.
converted 2042 PNGs: 131.0 MB -> 92.5 MB (-29.4%)
images/ tree: 218 MB -> 179 MB
3737 text files updated; internal-link check passes with 0 errors
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
