From 67dd7104a6b0b65059c616753110f339ef46ed99 Mon Sep 17 00:00:00 2001 From: generall Date: Sat, 7 Nov 2026 10:35:55 +0100 Subject: [PATCH] fix: dead search link and unstable snippet order in overrides Pin the SDK order used by generate_snippet_overwrites.py to the order already committed in the overrides, so regeneration is deterministic without reordering existing files. Co-Authored-By: Claude Opus 5.5 --- fern/pages/api-summary.mdx | 2 +- tools/generate_snippet_overwrites.py | 8 +++++++- 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/fern/pages/api-summary.mdx b/fern/pages/api-summary.mdx index ca3b68c..88a4b63 100644 --- a/fern/pages/api-summary.mdx +++ b/fern/pages/api-summary.mdx @@ -4,7 +4,7 @@ Qdrant is a [vector database](https://qdrant.tech/documentation/overview/) and a 1. First, you should create a [collection](/api-reference/collections/create-collection) to store all your data. 2. Then upsert data [points](/api-reference/points/upsert-points) and enrich them with a custom [payload](/api-reference/points/set-payload). -3. With a full collection, run a [search](/api-reference/search/points) to find relevant results. +3. With a full collection, run a [search](/api-reference/search/query-points) to find relevant results. 4. Collections can be [snapshotted, downloaded and restored](/api-reference/snapshots/list-snapshots). 5. When ready, setup a [distributed system](/api-reference/distributed/create-shard-key) for production. diff --git a/tools/generate_snippet_overwrites.py b/tools/generate_snippet_overwrites.py index 8bf3c60..10565dc 100644 --- a/tools/generate_snippet_overwrites.py +++ b/tools/generate_snippet_overwrites.py @@ -27,6 +27,8 @@ 'curl': '.sh', } +SDK_ORDER = ['java', 'python', 'typescript', 'curl', 'csharp', 'go', 'rust'] + def parse_openapi_spec(path: str): """ @@ -131,7 +133,11 @@ def main(): - all_sdks = [sdk.split('/')[-1] for sdk in glob.glob("snippets/*")] + # Fixed order matches the committed overrides; glob order is filesystem-dependent. + all_sdks = sorted( + (sdk.split('/')[-1] for sdk in glob.glob("snippets/*")), + key=lambda sdk: (SDK_ORDER.index(sdk) if sdk in SDK_ORDER else len(SDK_ORDER), sdk), + ) overwrites = defaultdict(lambda: defaultdict(dict))