New Information Architecture #622
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
- Migrated 176 files with 2,657 link updates total - Updated links from /home/ paths to new structure: - /get-started/ for onboarding content - /guides/ for how-to guides - /references/ for reference documentation - /resources/ for supplementary content - Based on URL mappings from docs-migration.csv 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
nearestnabors
force-pushed
the
new-ia-backup
branch
from
db404a0 to
f3c7c3a
Compare
- Added 61 permanent (308) redirects in next.config.ts - Maps old /home/ paths to new information architecture - Uses Next.js redirects() for server-side handling - SEO-friendly: search engines will update their indexes 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
- Updated 119 files with remaining /home/ references - Fixed links with anchors and query parameters - Ensured all internal links point to new IA structure - Comprehensive mapping of all /home/ paths to new locations 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
nearestnabors
force-pushed
the
new-ia-backup
branch
from
45b3e52 to
67c1e41
Compare
nearestnabors
force-pushed
the
new-ia-backup
branch
from
84c199a to
67c1e41
Compare
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
| ## Next Steps | ||
|
|
||
| - Learn more about [MCP Gateways](/home/mcp-gateways). | ||
| - Learn more about [MCP Gateways](/guides/create-tools/mcp-gateways. |
There was a problem hiding this comment.
Missing closing parentheses break multiple markdown links
Several markdown links are missing their closing ), breaking the link syntax. For example, [MCP Gateways](/guides/create-tools/mcp-gateways. is missing the closing parenthesis. This affects multiple files including call-tool-client/page.mdx, arcade-deploy/page.mdx, cursor/page.mdx, visual-studio-code/page.mdx, and securing-arcade-mcp/page.mdx. These broken links will render incorrectly and fail to navigate users to the intended destinations.
Additional Locations (2)
| Arcade Deploy](/home/serve-tools/arcade-deploy) guide or the [on-prem MCP | ||
| server](/home/deployment/on-prem-mcp) guide for secure remote deployment. | ||
| Arcade Deploy](/guides/deployment-hosting/arcade-deploy) guide or the [on-prem MCP | ||
| server](/guides/deployment-hosting/on-prem guide for secure remote deployment. |
There was a problem hiding this comment.
Missing closing parenthesis in on-prem documentation links
Links to the on-prem deployment guide are malformed with missing closing parentheses: /guides/deployment-hosting/on-prem guide instead of /guides/deployment-hosting/on-prem). This occurs in multiple documentation files including mcp-server-quickstart/page.mdx, build-mcp-server/page.mdx, call-tools-mcp/page.mdx, create-tool-secrets/page.mdx, and deployment-hosting/page.mdx.
Additional Locations (2)
| | http | local ([unprotected](/resources/glossaryunprotected-mcp-servers)) | ✅ | ❌ | ❌ | ❌ | | ||
| | http | remote ([unprotected](/resources/glossaryunprotected-mcp-servers)) | ✅ | ❌ | ❌ | ❌ | | ||
| | http | local ([protected](/resources/glossaryprotected-mcp-servers)) `coming soon` | ✅ | ✅ | ✅ | ✅ | | ||
| | http | remote ([protected](/resources/glossaryprotected-mcp-servers)) | ✅ | ✅ | ✅ | ✅ | |
There was a problem hiding this comment.
Glossary anchor links missing hash symbol
The glossary links are missing the # hash separator between the path and anchor. For example, /resources/glossaryunprotected-mcp-servers should be /resources/glossary#unprotected-mcp-servers. All four glossary links in the table are affected, which will result in 404 errors instead of navigating to the correct glossary sections.
| ## Next Steps | ||
|
|
||
| In this simple example, we call the tool methods directly. In your real applications and agents, you'll likely be letting the LLM decide which tools to call. Learn more about using Arcade with Frameworks in the [Frameworks](/home/langchain/use-arcade-tools) section, or [how to build your own tools](/home/build-tools/create-a-mcp-server). | ||
| In this simple example, we call the tool methods directly. In your real applications and agents, you'll likely be letting the LLM decide which tools to call. Learn more about using Arcade with Frameworks in the [Frameworks](/guides/agent-frameworks/langchain/python section, or [how to build your own tools](/guides/create-tools/tool-basics/build-mcp-server). |
There was a problem hiding this comment.
Broken link missing closing parenthesis in agent guide
The markdown link [Frameworks](/guides/agent-frameworks/langchain/python section, is malformed - it's missing the closing ) before the comma and also has the word "section" incorrectly placed inside the URL. This breaks both the link syntax and will cause rendering issues.
| * [Visual Studio Code](/home/mcp-clients/visual-studio-code) | ||
| * [Cursor](/guides/tool-calling/mcp-client/visual-studio-code) | ||
| * [Claude Desktop](/guides/tool-calling/mcp-client/visual-studio-code) | ||
| * [Visual Studio Code](/guides/tool-calling/mcp-client/visual-studio-code) |
There was a problem hiding this comment.
MCP client links all point to VS Code page
All three MCP client links (Cursor, Claude Desktop, and Visual Studio Code) incorrectly point to the same /guides/tool-calling/mcp-client/visual-studio-code path. Cursor and Claude Desktop should link to their respective documentation pages, not the VS Code page.
| - Learn how to [use Arcade tools](/home/mastra/use-arcade-tools) in a Mastra agent | ||
| - Implement [user authentication handling](/home/mastra/user-auth-interrupts) for tools in multi-user applications | ||
| - Learn how to [use Arcade tools](/resources/mastra/use-arcade-tools) in a Mastra agent | ||
| - Implement [user authentication handling](/resources/mastra/user-auth-interrupts) for tools in multi-user applications |
There was a problem hiding this comment.
Incorrect paths reference non-existent /resources/ routes
Links in the Mastra and OpenAI Agents documentation incorrectly point to /resources/mastra/ and /resources/oai-agents/ paths, but the actual files are located under /guides/agent-frameworks/mastra/ and /guides/agent-frameworks/openai-agents/. These links will result in 404 errors.
Additional Locations (1)
| ## Quick Comparison | ||
|
|
||
| | Aspect | [Resource Server Auth (Front-Door)](/home/build-tools/secure-your-mcp-server) | [Tool-Level Authorization](/home/build-tools/create-a-tool-with-auth) | | ||
| | Aspect | [Resource Server Auth (Front-Door)](/guides/security/secure-your-mcp-server | [Tool-Level Authorization](/guides/create-tools/tool-basics/create-tool-auth) | |
There was a problem hiding this comment.
Missing closing parenthesis in table header link
The markdown table header contains a broken link: [Resource Server Auth (Front-Door)](/guides/security/secure-your-mcp-server | is missing the closing ) before the pipe character. This will cause the table rendering to break and the link to be non-functional.
|
|
||
| - [Using Arcade tools](/home/google-adk/use-arcade-tools) - Learn the basics of using Arcade tools with Google ADK | ||
| - [Creating custom tools](/home/build-tools/create-a-mcp-server) - Build your own tools with the Arcade Tool SDK | ||
| - [Using Arcade tools](/guides/agent-frameworks/google-adk/python) - Learn the basics of using Arcade tools with Google ADK |
There was a problem hiding this comment.
Incorrect path uses /python instead of /use-arcade-tools
The link [Using Arcade tools](/guides/agent-frameworks/google-adk/python) points to a non-existent /python path. Based on the file structure in the _meta.tsx, the correct path should be /guides/agent-frameworks/google-adk/use-arcade-tools to match the actual documentation page.
| OAuth app credentials and add them to Arcade. For example, see our docs on | ||
| [configuring Google auth in the Arcade | ||
| Dashboard](/home/auth-providers/google#access-the-arcade-dashboard). | ||
| Dashboard](/references/auth-providers/googleaccess-the-arcade-dashboard). |
There was a problem hiding this comment.
Missing hash symbol in Google auth provider anchor link
The link /references/auth-providers/googleaccess-the-arcade-dashboard is missing the # hash symbol between the path and anchor. It should be /references/auth-providers/google#access-the-arcade-dashboard. This will result in a 404 instead of navigating to the correct section.
nearestnabors
requested review from
evantahler,
sdserranog,
torresmateo and
vfanelle
|
For some reason the integrations aren't being listed alphabetically within their respective category. Additional thoughts (feel free to ignore):
|
evantahler
left a comment
evantahler
left a comment
There was a problem hiding this comment.
I did a review based on the preview site holistically - I haven't reviewed the code. If you would like a code review, @ me on a page and I can take a look!
In general, I like the new IA - I like both the high level categories, and how the user works down form intro to advanced topics as they go.
Some blocking items:
- The sidebar links in the "references" section do not work (either 404 or 'too many redirects'), except for 'auth providers'
- Navigationally, the list of integrations/toolkits moving under 'resources' is fine, but this page is really important for the "should I use Arcade" decision making process. I think that means is should have a top-nav link as well. It should also be called out in some way to differentiate the importance of that page.
- I agree with @EricGustin that the tool-type categorization (productivity, sales, etc) probably matters less than the list of APIs we we support. A categorization I do think matters now is "starter" vs "optimized". We should focus on the starter tools and de-emphasize the starter tools - they are mixed now.
- 'Submit your Server' doesn't do anything
Questions I have:
- The new 'about arcade' is good! How does that relate to the 'home' page - can they be merged or are they doing different jobs?
|
One more nit - the |
Preview
Note
Implements a major documentation IA overhaul with new top-level sections and extensive path/link updates.
app/en/get-started,app/en/guides,app/en/references,app/en/resources; adds many corresponding_meta.tsxfiles and pages; removes legacyhomemetas/pagesBadgeinLogo, updatesToolInfo/StarterToolInfolink targets, changeseditPagelabel textresources/examplesWritten by Cursor Bugbot for commit d9c3dab. This will update automatically on new commits. Configure here.