From 10c6b7cf826282f7a33e6b64af708d1429b7ab01 Mon Sep 17 00:00:00 2001 From: ovenmitt <99039876+ovenmitt@users.noreply.github.com> Date: Fri, 6 Nov 2026 19:23:43 -0500 Subject: [PATCH 1/5] Merge API reference into the Hosted API tab Rename the API tab to Hosted API and fold the API reference group (overview, rate limits, error codes, OpenAPI endpoints) into it so the guides and reference live in one place. Co-Authored-By: Claude Opus 5.5 --- docs.json | 9 ++------- 1 file changed, 2 insertions(+), 7 deletions(-) diff --git a/docs.json b/docs.json index 9c1d1d27..d611b790 100644 --- a/docs.json +++ b/docs.json @@ -179,7 +179,7 @@ ] }, { - "tab": "API", + "tab": "Hosted API", "groups": [ { "group": "Get started", @@ -207,12 +207,7 @@ "api/guides/batch", "api/guides/your-data" ] - } - ] - }, - { - "tab": "API reference", - "groups": [ + }, { "group": "API reference", "icon": "code", From a5fc26c7ead4a6ae507f49be923cceef57230be5 Mon Sep 17 00:00:00 2001 From: ovenmitt <99039876+ovenmitt@users.noreply.github.com> Date: Fri, 6 Nov 2026 19:23:54 -0500 Subject: [PATCH 2/5] Split the LFM tab into Models, Fine-tune, and Deploy The LFM tab held seven unrelated groups, so users couldn't tell from the nav where fine-tuning or deployment docs lived. Give each job its own tab: Models (catalog, key concepts, guides, help), Fine-tune, and Deploy (edge, GPU, cloud inference). Page URLs are unchanged. Co-Authored-By: Claude Opus 5.5 --- docs.json | 58 ++++++++++++++++++++++++++++++++----------------------- 1 file changed, 34 insertions(+), 24 deletions(-) diff --git a/docs.json b/docs.json index d611b790..8acc8aa8 100644 --- a/docs.json +++ b/docs.json @@ -83,7 +83,7 @@ "navigation": { "tabs": [ { - "tab": "LFM", + "tab": "Models", "groups": [ { "group": "Models", @@ -111,6 +111,33 @@ "lfm/key-concepts/speculative-decoding" ] }, + { + "group": "Guides", + "icon": "book-open", + "pages": [ + "guides/hardware-evaluation", + "guides/use-case-evaluation", + "guides/migration-guide", + "guides/decision-model-guide" + ] + }, + { + "group": "Help", + "icon": "book", + "pages": [ + "lfm/help/faqs", + "lfm/help/troubleshooting", + "lfm/help/deprecations", + "lfm/help/contributing", + "lfm/help/connect-ai-tools", + "lfm/help/model-license" + ] + } + ] + }, + { + "tab": "Fine-tune", + "groups": [ { "group": "Fine-tuning", "icon": "sliders", @@ -121,7 +148,12 @@ "lfm/fine-tuning/trl", "lfm/fine-tuning/unsloth" ] - }, + } + ] + }, + { + "tab": "Deploy", + "groups": [ { "group": "Edge Inference", "icon": "mobile", @@ -153,28 +185,6 @@ "deployment/gpu-inference/baseten", "deployment/gpu-inference/fal" ] - }, - { - "group": "Guides", - "icon": "book-open", - "pages": [ - "guides/hardware-evaluation", - "guides/use-case-evaluation", - "guides/migration-guide", - "guides/decision-model-guide" - ] - }, - { - "group": "Help", - "icon": "book", - "pages": [ - "lfm/help/faqs", - "lfm/help/troubleshooting", - "lfm/help/deprecations", - "lfm/help/contributing", - "lfm/help/connect-ai-tools", - "lfm/help/model-license" - ] } ] }, From 01eeb0f7a6ac574d41af8dc4071f01847f622f8f Mon Sep 17 00:00:00 2001 From: ovenmitt <99039876+ovenmitt@users.noreply.github.com> Date: Fri, 6 Nov 2026 19:24:08 -0500 Subject: [PATCH 3/5] Rename the Examples tab to Tutorials Nearly every page in the tab is an end-to-end build with a working result, which is a tutorial in Diataxis terms. Rename the tab and drop the repeated word from the group names (Laptop, Android, Web, Fine-tuning), and retitle the landing page to match. Co-Authored-By: Claude Opus 5.5 --- docs.json | 10 +++++----- examples/index.mdx | 10 +++++----- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docs.json b/docs.json index 8acc8aa8..ba2b68e2 100644 --- a/docs.json +++ b/docs.json @@ -238,7 +238,7 @@ ] }, { - "tab": "Examples", + "tab": "Tutorials", "groups": [ { "group": "Getting Started", @@ -250,7 +250,7 @@ ] }, { - "group": "Laptop Examples", + "group": "Laptop", "icon": "laptop", "pages": [ "examples/laptop-examples/invoice-extractor-tool-with-liquid-nanos", @@ -264,7 +264,7 @@ ] }, { - "group": "Android Examples", + "group": "Android", "icon": "robot", "pages": [ "examples/android/slogan-generator", @@ -275,7 +275,7 @@ ] }, { - "group": "Web Examples", + "group": "Web", "icon": "globe", "pages": [ "examples/web/vl-webgpu-demo", @@ -284,7 +284,7 @@ ] }, { - "group": "Model Customization", + "group": "Fine-tuning", "icon": "sliders", "pages": [ "examples/customize-models/car-maker-identification", diff --git a/examples/index.mdx b/examples/index.mdx index e1f79922..ae873674 100644 --- a/examples/index.mdx +++ b/examples/index.mdx @@ -1,6 +1,6 @@ --- -title: "Examples Library" -description: "Browse example projects and tutorials built with Liquid AI LFM models across laptop, Android, web, and fine-tuning use cases." +title: "Tutorials" +description: "Step-by-step tutorials for building apps with Liquid AI LFM models across laptop, Android, web, and fine-tuning use cases." --- ## Laptop @@ -44,7 +44,7 @@ description: "Browse example projects and tutorials built with Liquid AI LFM mod ## Android -These Android examples were built with the LEAP SDK, which is now deprecated. For new apps, embed llama.cpp directly — see [iOS & Android](/deployment/on-device/llama-cpp/mobile). +These Android tutorials were built with the LEAP SDK, which is now deprecated. For new apps, embed llama.cpp directly — see [iOS & Android](/deployment/on-device/llama-cpp/mobile). @@ -111,12 +111,12 @@ These Android examples were built with the LEAP SDK, which is now deprecated. Fo -## Cannot find the example you need? +## Can't find the tutorial you need? - Connect with the community and let us know what examples you'd like to see. + Connect with the community and let us know what tutorials you'd like to see. From 57d6517514f1b3a0892d9120900dcee5b102765c Mon Sep 17 00:00:00 2001 From: ovenmitt <99039876+ovenmitt@users.noreply.github.com> Date: Fri, 6 Nov 2026 19:24:25 -0500 Subject: [PATCH 4/5] Move agent harnesses to Deploy, redirect duplicate Connect AI Tools "Run local agents with LFMs" is a how-to for serving a model and wiring up agent harnesses, so list it under a new Deploy > Agents group (the URL is unchanged). Examples' Connect AI Tools page was a copy of the Help page with a canonical pointing there; delete it and redirect its URL. Co-Authored-By: Claude Opus 5.5 --- docs.json | 15 ++++++++++++--- examples/connect-ai-tools.mdx | 9 --------- 2 files changed, 12 insertions(+), 12 deletions(-) delete mode 100644 examples/connect-ai-tools.mdx diff --git a/docs.json b/docs.json index ba2b68e2..3a34cdb1 100644 --- a/docs.json +++ b/docs.json @@ -185,6 +185,13 @@ "deployment/gpu-inference/baseten", "deployment/gpu-inference/fal" ] + }, + { + "group": "Agents", + "icon": "robot", + "pages": [ + "examples/agent-harnesses" + ] } ] }, @@ -244,9 +251,7 @@ "group": "Getting Started", "icon": "rocket", "pages": [ - "examples/index", - "examples/connect-ai-tools", - "examples/agent-harnesses" + "examples/index" ] }, { @@ -314,6 +319,10 @@ "source": "/lfm/getting-started/connect-ai-tools", "destination": "/lfm/help/connect-ai-tools" }, + { + "source": "/examples/connect-ai-tools", + "destination": "/lfm/help/connect-ai-tools" + }, { "source": "/lfm/getting-started/model-license", "destination": "/lfm/help/model-license" diff --git a/examples/connect-ai-tools.mdx b/examples/connect-ai-tools.mdx deleted file mode 100644 index 819a7bdb..00000000 --- a/examples/connect-ai-tools.mdx +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: "Connect AI Tools" -description: "Connect your AI coding tools to Liquid Docs via MCP for live, queryable access to documentation" -canonical: "https://docs.liquid.ai/lfm/help/connect-ai-tools" ---- - -import ConnectAiTools from "/snippets/connect-ai-tools.mdx"; - - From 848fda6047f2bac0fd32413e8801554add8cdda4 Mon Sep 17 00:00:00 2001 From: ovenmitt <99039876+ovenmitt@users.noreply.github.com> Date: Fri, 6 Nov 2026 19:24:33 -0500 Subject: [PATCH 5/5] Update README and CLAUDE.md for the Hosted API tab Co-Authored-By: Claude Opus 5.5 --- CLAUDE.md | 2 +- README.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 1950d361..b16822f1 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -191,7 +191,7 @@ grep -r '/>' --include="*.mdx" --include="*.md" . ## Liquid API Reference -`api/openapi.json` generates the endpoint pages of the API reference tab. Never edit it by hand: it is exported from the console repository's endpoint registry (`apps/web/lib/api/docs.ts`) with `bun run openapi:export`. Change the endpoint docs there and re-export. See the README's "Liquid API Reference" section. +`api/openapi.json` generates the endpoint pages under API reference in the Hosted API tab. Never edit it by hand: it is exported from the console repository's endpoint registry (`apps/web/lib/api/docs.ts`) with `bun run openapi:export`. Change the endpoint docs there and re-export. See the README's "Liquid API Reference" section. ## Link Snapshot Contract diff --git a/README.md b/README.md index 86a94b0e..67fe64dd 100644 --- a/README.md +++ b/README.md @@ -172,7 +172,7 @@ For more details on Mintlify setup and configuration, visit the [official Mintli ### Liquid API Reference -The **API** and **API reference** tabs document the hosted Liquid API served by Liquid Console. The endpoint pages under **API reference** are generated by Mintlify from [`api/openapi.json`](./api/openapi.json). Don't edit that file by hand: it is exported from the endpoint registry in the console repository (`apps/web/lib/api/docs.ts`). After an API change lands there, regenerate it from the console's `apps/web` directory and open a pull request here with the result: +The **Hosted API** tab documents the hosted Liquid API served by Liquid Console. The endpoint pages under **API reference** are generated by Mintlify from [`api/openapi.json`](./api/openapi.json). Don't edit that file by hand: it is exported from the endpoint registry in the console repository (`apps/web/lib/api/docs.ts`). After an API change lands there, regenerate it from the console's `apps/web` directory and open a pull request here with the result: ```bash bun run openapi:export /api/openapi.json