Skip to content

Phase 0 docs 3/3: delete intentionally orphaned pages - #310

Open
kylegani wants to merge 1 commit into
kyle/phase0-docs-contentfrom
kyle/phase0-docs-orphans
Open

Phase 0 docs 3/3: delete intentionally orphaned pages#310
kylegani wants to merge 1 commit into
kyle/phase0-docs-contentfrom
kyle/phase0-docs-orphans

Conversation

@kylegani

@kylegani kylegani commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Context

Part of Phase 0 of the Agentic Cerebrium initiative: making Cerebrium fully usable by coding agents (Claude Code, Cursor, Codex, Copilot). Agents consume these docs through the Mintlify MCP server, llms.txt, and .md exports; pages that are orphaned but still fetchable feed agents stale content.

This PR is layer 3 of a 3-PR stack (one reviewable unit per layer, merge bottom-up; merging a lower layer auto-retargets the ones above):

  1. Phase 0 docs 1/3: MCP proxy wiring and contextual agent config #308 MCP proxy wiring + contextual agent config
  2. Phase 0 docs 2/3: content accuracy fixes (defaults, GPU tables, curl snippets, regions) #309 content accuracy fixes (defaults, GPU tables, curl snippets, regions)
  3. Phase 0 docs 3/3: delete intentionally orphaned pages #310 delete intentionally orphaned pages (+ redirects)

Changes

8 pages exist in the repo but were deliberately left out of the docs.json nav (confirmed intentional). Orphaned Mintlify pages remain reachable by direct URL and by agents, so this deletes them outright:

  • changelog.mdx
  • getting-started/collaborating.mdx
  • integrations/vercel.mdx
  • other-topics/fitting-large-models-on-small-gpus.mdx
  • v4/examples/aiVoiceAgents.mdx (near-exact dupe of realtime-voice-agents)
  • v4/examples/langchain.mdx
  • v4/examples/mistral-vllm.mdx
  • v4/examples/streaming-falcon-7B.mdx

Cleanup that keeps the site consistent:

  • v4/examples/featured.mdx: removed the "Advanced concepts" tab whose only two cards linked to the deleted mistral-vllm and streaming-falcon-7B pages.
  • docs.json: added 5 redirects for deleted URLs with obvious surviving targets, following the repo's existing redirect patterns (aiVoiceAgents -> realtime-voice-agents, langchain -> langchain-langsmith, mistral-vllm -> openai-compatible-endpoint-vllm, streaming-falcon-7B -> featured, fitting-large-models -> introduction). The existing v3/legacy redirects already pointed AWAY from these pages, so none break.
  • No redirects added for /changelog, /getting-started/collaborating, /integrations/vercel: no sensible surviving target exists, so they will 404 by design. Flag in review if any of the three should redirect somewhere instead.

Inbound-reference audit: repo-wide grep found no remaining links to any deleted page (the only two, in featured.mdx, are removed here; integrations/vercel.mdx also referenced mistral-vllm but is itself deleted).

How to test this layer

  1. python3 -m json.tool docs.json > /dev/null parses.
  2. On the preview deployment: the deleted URLs with redirects land on their targets; /changelog, /getting-started/collaborating, /integrations/vercel return 404; /v4/examples/featured renders without the "Advanced concepts" tab and with no broken cards.
  3. grep -rn "mistral-vllm\|streaming-falcon-7B\|aiVoiceAgents\|collaborating" --include="*.mdx" . shows no links to deleted pages.

Stack position: 3 of 3 (base: kyle/phase0-docs-content). Merging this merges the layers below it.

🤖 Generated with Claude Code

@kylegani kylegani changed the title Rehome orphan docs pages and drop duplicate voice-agents example Phase 0 docs 3/3: orphan-page cleanup and nav rehoming Aug 4, 2026
@kylegani
kylegani force-pushed the kyle/phase0-docs-orphans branch from b174de9 to 41a1f4a Compare August 4, 2026 09:59
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@kylegani
kylegani force-pushed the kyle/phase0-docs-orphans branch from 41a1f4a to d271497 Compare August 4, 2026 11:06
@kylegani kylegani changed the title Phase 0 docs 3/3: orphan-page cleanup and nav rehoming Phase 0 docs 3/3: delete intentionally orphaned pages Aug 4, 2026
@kylegani
kylegani marked this pull request as ready for review August 4, 2026 11:58
@kylegani
kylegani requested a review from milo157 as a code owner August 4, 2026 11:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants