docs: per-product LLM docs indexes for all products + global directory - #532
raj-dubey1 wants to merge 6 commits into
Conversation
…rectory Extends the existing scoped LLM index convention (UI Kits + Chat SDKs already shipped as unlisted llms-*.mdx) to every remaining product, and adds a global directory that links them all. New scoped indexes (generated from docs.json navigation so every link is a real, current page — 902 links, 0 broken): - Voice & Video Calling, AI Agents, AI Moderation, Notifications, Campaigns, Insights, Vue UI Kit, Chat Widget, Chat REST & Management APIs, Chat Fundamentals. New global directory: - llms-index.mdx (served at /docs/llms-index) — links all scoped indexes; distinct from Mintlify's auto site-wide /llms.txt and /llms-full.txt (which it points to). Added to the Developer Tools nav group so the set is discoverable. Per-product indexes stay unlisted (not hidden) per the existing convention: built, served as .md twins, and indexed for search + AI, but kept out of the human sidebar. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PT9pMg3MSZEW3gsb6jPc3E
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
…fied headings, cleaner labels Addresses @ketanyekale's review of the generated indexes: - Calls: no longer mixes v4/v5 — current version (v5) only, and headings are platform-qualified (e.g. "## JavaScript — Getting Started") so identical page labels like "Setup" can't route an agent to the wrong platform. (0 /calls/v4 links.) - Vue: v4 menu only — dropped v3/v2 pages and their garbled labels. (0 3.0/2.0 links.) - No empty headings (unnamed nav groups fall back to a real section name). - Duplicate labels within a section disambiguated (e.g. widget grouped by platform: ## HTML / ## WordPress …); capitalization fixed (JavaScript, HTML, WordPress, Next.js). - llms-index.mdx: plain & (not &); Insights points straight at /insights. - Removed insights/llms-insights.mdx (single link — not worth an index). Regenerated from docs.json navigation, current version only: 869 links, 0 broken. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PT9pMg3MSZEW3gsb6jPc3E
…e human sidebar) Per request: the global directory is for agents/search, not users. Removed it from the docs.json Developer Tools nav (so it's not in the sidebar) and added the same 'unlisted, not hidden' note as the per-product indexes. It still builds, serves at /docs/llms-index, and stays indexable for search + AI. This PR now makes NO docs.json change — purely additive, unlisted pages. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PT9pMg3MSZEW3gsb6jPc3E
… llms pages Removed the <Note> callout so the directory renders as a plain markdown links page like every per-product llms-* index (frontmatter + comment + headings + bullet links). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PT9pMg3MSZEW3gsb6jPc3E
…k labels - Merge current main and regenerate the scoped indexes from docs.json navigation - "An AI Agents-scoped" (article picked from the scope name, fixed in the generator) - Framework labels: AG2, AG-UI, CrewAI, LangGraph (were Ag2, Ag UI, Crew AI, Langgraph) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01NgVCxHs3h8m72GXvC8HaV1
|
Refreshed on current
🤖 Generated with Claude Code |
Extends the existing scoped LLM index convention to every remaining product, and adds a single global directory that links them all. Everything here is for AI agents / search, not the human sidebar.
Background
We already ship per-product
llms-*.mdxscoped indexes for the 6 UI Kits and 5 Chat SDKs — unlisted (not in nav) but built, served as.mdtwins, and indexed for search + AI. The other products had none, and there was no central entry point. This PR fills the gaps.What's new (all unlisted — for LLMs, not users)
9 new scoped indexes, generated from
docs.jsonnavigation, current version only, so links are real and never version-mixed:1 global directory —
llms-index.mdx, served at/docs/llms-index(deliberately a different name fromllms.txt):/llms.txt+/llms-full.txt.UNLISTED, NOT hidden: omitted fromdocs.jsonnav but built, served, and indexable for search + AI. This PR makes nodocs.jsonchange.Quality (addressing review)
/calls/v4links); Vue is v4-only (03.0/2.0links).## JavaScript — Getting Started) so identical labels likeSetup/Integrationcan't route an agent to the wrong platform.¬&./insights.Safety
docs.jsonvalid & unchanged vs main; 869 links across all indexes + the directory, 0 broken.🤖 Generated with Claude Code
https://claude.ai/code/session_01PT9pMg3MSZEW3gsb6jPc3E