Skip to content

Restructure AI docs into agentic-coding and vibe-coding#3002

Open
atharvadeosthale wants to merge 2 commits into
mainfrom
cleanup-ai-docs
Open

Restructure AI docs into agentic-coding and vibe-coding#3002
atharvadeosthale wants to merge 2 commits into
mainfrom
cleanup-ai-docs

Conversation

@atharvadeosthale
Copy link
Copy Markdown
Member

  • Split /docs/tooling/ai/ai-dev-tools into /agentic-coding (IDEs + CLI agents) and /vibe-coding (prompt-to-app tools); delete legacy /docs/tooling/mcp section
  • Update all active refs (sidebar, AI overview, marketing, partial, responsible-ai); redirects cover old /mcp/* and /ai-dev-tools/* paths

…coding, drop legacy /docs/tooling/mcp section
@appwrite
Copy link
Copy Markdown

appwrite Bot commented May 18, 2026

Appwrite Website

Project ID: 69d7efb00023389e8d27

Sites (1)
Site Status Logs Preview QR
 website
69d7f2670014e24571ca
Building Building View Logs Preview URL QR Code

Website (appwrite/website)

Project ID: 684969cb000a2f6c0a02

Sites (1)
Site Status Logs Preview QR
 website
68496a17000f03d62013
Queued Queued View Logs Preview URL QR Code


Tip

Realtime gives you live updates for users, storage, functions, and databases

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented May 18, 2026

Greptile Summary

This PR restructures the AI docs by splitting the old /docs/tooling/ai/ai-dev-tools section into /agentic-coding (IDE + CLI agents) and /vibe-coding (prompt-to-app tools), and removes the legacy /docs/tooling/mcp section. Redirects are added for all old /mcp/* and /ai-dev-tools/* paths, and the sidebar, AI overview page, marketing components, and the shared partial are updated.

  • All redirects in redirects.json are present and correct; every old path has a valid destination covering both the /mcp/ and /ai-dev-tools/ namespaces.
  • src/routes/docs/+page.svelte and src/routes/(marketing)/(components)/platforms.svelte were only partially updated — items previously at /ai-dev-tools/ paths were migrated, but entries that already used /mcp/ paths (Claude Code, Cursor, VS Code, OpenCode, Antigravity, Claude Desktop, Zenflow) were left unchanged. The files now mix three URL schemes; links still resolve via redirects but the source is inconsistent.

Confidence Score: 5/5

Safe to merge — all deleted pages have redirects, no broken links introduced.

The restructuring is complete for the sidebar, overview, and shared partial. The remaining stale /mcp/ hrefs in the docs hub and marketing strip are covered by the redirect table, so no user-facing breakage occurs.

src/routes/docs/+page.svelte and src/routes/(marketing)/(components)/platforms.svelte contain a mix of old /mcp/ and new canonical paths that could be cleaned up.

Important Files Changed

Filename Overview
src/routes/docs/+page.svelte Partially updated: Codex, Lovable, Emergent, Bolt hrefs migrated to new paths, but Claude Code, Cursor, VS Code, OpenCode, Antigravity, Claude Desktop, and Zenflow still reference old /docs/tooling/mcp/ paths.
src/routes/(marketing)/(components)/platforms.svelte Partially updated: Codex and Lovable migrated to new paths, but Claude Code, Cursor, and OpenCode still reference old /docs/tooling/mcp/ paths.
src/redirects.json All old /mcp/* and /ai-dev-tools/* paths have redirect entries covering every tool page; no missing redirects found.
src/routes/docs/tooling/ai/+layout.svelte Sidebar links fully migrated from /ai-dev-tools/ to /agentic-coding/ and /vibe-coding/; structure matches the new directory layout.
src/routes/docs/tooling/ai/+page.markdoc Overview page cards fully migrated to new agentic-coding and vibe-coding URL paths for both light and dark variants.
src/partials/mcp-add-ides-tools.md All card hrefs updated to new paths; Cursor and Zenflow previously flagged stale hrefs are now corrected in this PR.
src/routes/(marketing)/(components)/ai.svelte All six agentic-coding tool hrefs fully migrated from /ai-dev-tools/ to /agentic-coding/.
src/routes/docs/tooling/ai/responsible-ai/+page.markdoc Single link change: ai-dev-tools/cursor replaced with /docs/tooling/ai/ for the "Cursor, VS Code, or Claude Code" anchor text.

Reviews (2): Last reviewed commit: "Fix stale links in mcp partial and respo..." | Re-trigger Greptile

Comment thread src/partials/mcp-add-ides-tools.md Outdated
Comment thread src/partials/mcp-add-ides-tools.md Outdated
Comment thread src/routes/docs/tooling/ai/responsible-ai/+page.markdoc Outdated
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.

1 participant