Commit 957deea
New Information Architecture (#622)
* tentatively scaffolds new folder structure—very breaking, much sad
* Organize guides and resources.
* Update all internal documentation links to new IA structure
- 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 <[email protected]>
* Add server-side redirects for old URLs to new IA structure
- 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 <[email protected]>
* Fix remaining /home/ links throughout documentation
- 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 <[email protected]>
* 🤖 Regenerate LLMs.txt
* fixing missing closing brackets
* fix broken has links
* fix duplicate links
* update broken links
* more broken link and md fixes
* fix moar links
* update broken links
* correct infinite redirects
* fixing some messed up redirects and blank links
* 🤖 Regenerate LLMs.txt
* fix auth providers url generation
* Fix 75 broken links and resolve routing issues
Fixed multiple categories of broken links across the documentation:
Routing & Redirects:
- Removed infinite redirect loops (e.g., /en/references redirecting to itself)
- Added proper redirects for MCP paths (/en/references/mcp, /en/references/mcp/python)
- Added redirects for paths missing locale prefixes (/mcp-servers/* → /en/resources/integrations/*)
- Fixed paths to moved pages (e.g., api-key → api-keys, openai → openai-agents)
Link Corrections:
- Fixed malformed anchor links missing '#' separator (e.g., googleusing-google-auth → google#using-google-auth)
- Updated paths to point to correct locations (e.g., /guides/create-tools/contribute/registry-early-access)
- Fixed references in glossary to use correct anchor format
Test Updates:
- Enhanced broken-link-check.test.ts with comprehensive redirect whitelist
- Added handling for both /mcp-servers/* and /en/mcp-servers/* patterns
- Updated test to validate redirects match actual file structure
All 75 broken links now resolved. Both broken-link-check and internal-link-check tests pass.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <[email protected]>
* fix: make documentation routing language-agnostic
## Summary
Made the documentation system properly multilingual by removing hardcoded English locale prefixes from all internal links and redirect configurations. Nextra automatically handles locale routing, so explicit /en/ prefixes were causing issues and breaking multilingual support.
## Changes Made
### Redirect Configuration (next.config.ts)
- Removed /en/ prefixes from all redirect destinations
- Fixed infinite redirect loops where paths were redirecting to themselves
- Cleaned up duplicate entries from merge conflicts
- All redirects now use language-agnostic paths that work with any locale
- Verified all redirects from docs-migration.csv are present and correct
### Internal Links
- Updated all markdown files to remove hardcoded /en/ prefixes from internal links
- Fixed malformed anchor links that were missing '#' separators
- Corrected links pointing to wrong auth provider documentation
### Test Updates (tests/broken-link-check.test.ts)
- Updated link validation to handle language-agnostic paths
- Added redirect mappings for all known redirects
- Tests now properly validate links without locale prefixes
## Files Modified
- next.config.ts - Removed locale prefixes from all redirects
- app/en/references/changelog/page.mdx - Fixed malformed Google auth link
- app/en/resources/glossary/page.mdx - Fixed malformed Google auth links
- app/en/resources/tools/page.mdx - Removed /en/ from internal links
- app/en/resources/integrations/productivity/*.mdx - Fixed Google auth reference links
- tests/broken-link-check.test.ts - Updated to handle language-agnostic validation
## Testing
✅ All tests passing (0 broken links)
✅ Verified redirects work correctly without locale prefixes
✅ Confirmed Nextra handles locale routing automatically
✅ Cross-referenced all redirects with docs-migration.csv
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <[email protected]>
* Update old redirect paths and remove knownRedirects from test file
Updated all internal links to use the correct destination paths instead of redirect paths:
- /get-started/setup/api-key → /get-started/setup/api-keys
- /references/auth-providers/ → /references/auth-providers (removed trailing slash)
- /guides/tool-calling/ → /guides/tool-calling (removed trailing slash)
- /references/mcp/python/ → /references/mcp/python
- /guides/tool-calling/custom-apps/authorized-tool-calling → /guides/tool-calling/custom-apps/auth-tool-calling
- /guides/user-facing-agents/brand-provider → /guides/user-facing-agents/secure-auth-production
- /guides/tool-calling/mcp-client/* → /guides/tool-calling/mcp-clients/*
- /guides/tool-calling/get-tool-definitions → /guides/tool-calling/custom-apps/get-tool-definitions
- /guides/deployment-hosting/engine-configuration → /guides/deployment-hosting/configure-engine
- /guides/create-tools/performance/run-evaluations → /guides/create-tools/evaluate-tools/run-evaluations
- /references/arcade-cliarcade-configure → /references/arcade-cli
- /resources/creating-tools/tool-basics/build-mcp-server → /guides/create-tools/tool-basics/build-mcp-server
- /resources/mastra/user-auth-interrupts → /guides/agent-frameworks/mastra/user-auth-interrupts
Removed the knownRedirects mapping from the test file since all links now point directly to the correct paths.
All tests pass successfully.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <[email protected]>
* update reroutes
* remove and don't track .bak
* fix malformed urls
* Merge branch 'origin/main' into new-ia-backup - resolved conflicts
* Rectifying merge conflicts
* 🤖 Regenerate LLMs.txt
---------
Co-authored-by: Rachel Lee Nabors <[email protected]>
Co-authored-by: Claude <[email protected]>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>1 parent ea7c67c commit 957deea
File tree
421 files changed
+19859
-22416
lines changed- .github
- scripts
- workflows
- _dictionaries
- app
- _components
- en
- get-started
- about-arcade
- quickstarts
- call-tool-agent
- call-tool-client
- mcp-server-quickstart
- setup
- api-keys
- connect-arcade-docs
- guides
- agent-frameworks
- crewai
- custom-auth-flow
- use-arcade-tools
- google-adk
- overview
- use-arcade-tools
- langchain
- auth-langchain-tools
- use-arcade-tools
- use-arcade-with-langchain
- user-auth-interrupts
- mastra
- overview
- use-arcade-tools
- user-auth-interrupts
- openai-agents
- overview
- use-arcade-tools
- user-auth-interrupts
- vercelai
- using-arcade-tools
- create-tools
- contribute/registry-early-access
- error-handling
- retry-tools
- useful-tool-errors
- evaluate-tools
- create-evaluation-suite
- run-evaluations
- why-evaluate
- improve/types-of-tools
- mcp-gateways
- migrate-toolkits
- tool-basics
- build-mcp-server
- call-tools-mcp
- compare-server-types
- create-tool-auth
- create-tool-secrets
- organize-mcp-tools
- runtime-data-access
- deployment-hosting
- arcade-cloud
- arcade-deploy
- configure-engine
- on-prem
- security
- secure-your-mcp-server
- securing-arcade-mcp
- security-research-program
- tool-calling
- call-third-party-apis
- custom-apps
- auth-tool-calling
- check-auth-status
- get-tool-definitions
- error-handling
- mcp-clients
- claude-desktop
- cursor
- visual-studio-code
- user-facing-agents/secure-auth-production
- home
- auth
- build-tools
- compare-server-types
- evaluate-tools
- serve-tools
- use-tools
- learn/server-level-vs-tool-level-auth
- references
- arcade-cli
- auth-providers
- airtable
- asana
- atlassian
- calendly
- clickup
- discord
- dropbox
- figma
- github
- google
- hubspot
- linear
- linkedin
- mailchimp
- microsoft
- miro
- notion
- oauth2
- pagerduty
- reddit
- salesforce
- slack
- spotify
- square
- ticktick
- twitch
- x
- zendesk
- zoho
- zoom
- changelog
- mcp
- python
- transports
- telemetry
- resources
- contact-us
- examples
- faq
- glossary
- integrations
- components
- contribute-a-server
- customer-support
- customerio-api
- customerio-pipelines-api
- customerio-track-api
- freshservice-api
- intercom-api
- pagerduty
- pylon
- zendesk
- reference
- databases
- clickhouse
- mongodb
- postgres
- weaviate-api
- development
- arcade-engine-api
- brightdata
- cursor-agents-api
- datadog-api
- e2b
- figma
- firecrawl
- reference
- github-api
- github
- pagerduty-api
- posthog-api
- vercel-api
- zoho-creator-api
- entertainment
- imgflip
- spotify
- twitch
- payments
- stripe_api
- stripe
- zoho-books-api
- productivity
- airtable-api
- asana-api
- asana
- reference
- ashby-api
- box-api
- calendly-api
- clickup-api
- clickup
- reference
- closeio
- confluence
- dropbox
- reference
- figma-api
- gmail
- reference
- google-calendar
- reference
- google-contacts
- google-docs
- reference
- google-drive
- reference
- google-sheets
- reference
- google-slides
- jira
- environment-variables
- reference
- linear
- luma-api
- mailchimp-marketing-api
- miro-api
- notion
- obsidian
- outlook-calendar
- outlook-mail
- reference
- squareup-api
- ticktick-api
- trello-api
- xero-api
- sales
- hubspot-automation-api
- hubspot-cms-api
- hubspot-conversations-api
- hubspot-crm-api
- hubspot-events-api
- hubspot-marketing-api
- hubspot-meetings-api
- hubspot-users-api
- hubspot
- reference
- salesforce
- search
- exa-api
- google_finance
- google_flights
- google_hotels
- google_jobs
- google_maps
- google_news
- google_search
- google_shopping
- walmart
- youtube
- social-communication
- discord
- linkedin
- microsoft-teams
- reference
- reddit
- slack-api
- slack
- environment-variables
- install
- reference
- teams
- reference
- twilio
- reference
- x
- zoom
- install
- tools
- examples/code
- guides
- agentauth
- toolsdk
- home
- build-tools/create-a-tool
- configuration/engine
- crewai
- mcp/streamable-http
- use-tools
- call-tools-directly
- get-formatted-tool-definitions
- integrations
- asana
- atlassian
- clickup
- discord
- dropbox
- github
- google
- hubspot
- linear
- linkedin
- microsoft
- notion
- oauth2
- reddit
- salesforce
- slack
- spotify
- twitch
- x
- zendesk
- zoom
- public
- tests
Some content is hidden
Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
421 files changed
+19859
-22416
lines changed| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | | - | |
4 | | - | |
| 3 | + | |
| 4 | + | |
5 | 5 | | |
6 | 6 | | |
7 | 7 | | |
| |||
90 | 90 | | |
91 | 91 | | |
92 | 92 | | |
93 | | - | |
| 93 | + | |
| 94 | + | |
| 95 | + | |
| 96 | + | |
94 | 97 | | |
95 | 98 | | |
96 | 99 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
32 | 32 | | |
33 | 33 | | |
34 | 34 | | |
35 | | - | |
| 35 | + | |
36 | 36 | | |
37 | 37 | | |
38 | 38 | | |
| |||
121 | 121 | | |
122 | 122 | | |
123 | 123 | | |
124 | | - | |
| 124 | + | |
125 | 125 | | |
126 | 126 | | |
127 | 127 | | |
128 | 128 | | |
129 | | - | |
| 129 | + | |
130 | 130 | | |
131 | | - | |
| 131 | + | |
132 | 132 | | |
133 | 133 | | |
134 | 134 | | |
| |||
213 | 213 | | |
214 | 214 | | |
215 | 215 | | |
216 | | - | |
| 216 | + | |
217 | 217 | | |
218 | | - | |
| 218 | + | |
219 | 219 | | |
220 | 220 | | |
221 | 221 | | |
222 | 222 | | |
223 | | - | |
| 223 | + | |
224 | 224 | | |
225 | 225 | | |
226 | 226 | | |
227 | 227 | | |
228 | 228 | | |
229 | 229 | | |
230 | 230 | | |
231 | | - | |
| 231 | + | |
232 | 232 | | |
233 | 233 | | |
234 | 234 | | |
| |||
237 | 237 | | |
238 | 238 | | |
239 | 239 | | |
240 | | - | |
| 240 | + | |
241 | 241 | | |
242 | 242 | | |
243 | | - | |
| 243 | + | |
244 | 244 | | |
245 | 245 | | |
246 | 246 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
15 | 15 | | |
16 | 16 | | |
17 | 17 | | |
| 18 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
9 | 9 | | |
10 | 10 | | |
11 | 11 | | |
12 | | - | |
| 12 | + | |
13 | 13 | | |
14 | 14 | | |
15 | 15 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
3 | 3 | | |
4 | 4 | | |
5 | 5 | | |
6 | | - | |
| 6 | + | |
7 | 7 | | |
8 | 8 | | |
9 | 9 | | |
| |||
16 | 16 | | |
17 | 17 | | |
18 | 18 | | |
19 | | - | |
| 19 | + | |
20 | 20 | | |
21 | 21 | | |
22 | 22 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | | - | |
| 1 | + | |
2 | 2 | | |
3 | 3 | | |
4 | 4 | | |
5 | 5 | | |
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
9 | | - | |
| 9 | + | |
10 | 10 | | |
11 | 11 | | |
12 | 12 | | |
13 | 13 | | |
14 | | - | |
| 14 | + | |
15 | 15 | | |
16 | 16 | | |
17 | 17 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
2 | 2 | | |
3 | 3 | | |
4 | 4 | | |
5 | | - | |
| 5 | + | |
6 | 6 | | |
7 | 7 | | |
8 | | - | |
| 8 | + | |
9 | 9 | | |
10 | | - | |
| 10 | + | |
11 | 11 | | |
12 | | - | |
| 12 | + | |
13 | 13 | | |
14 | 14 | | |
15 | 15 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
10 | 10 | | |
11 | 11 | | |
12 | 12 | | |
13 | | - | |
| 13 | + | |
14 | 14 | | |
15 | 15 | | |
16 | 16 | | |
| |||
21 | 21 | | |
22 | 22 | | |
23 | 23 | | |
24 | | - | |
| 24 | + | |
25 | 25 | | |
26 | 26 | | |
27 | 27 | | |
28 | 28 | | |
29 | 29 | | |
30 | 30 | | |
31 | | - | |
32 | | - | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
33 | 34 | | |
34 | 35 | | |
35 | 36 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
7 | 7 | | |
8 | 8 | | |
9 | 9 | | |
10 | | - | |
11 | | - | |
| 10 | + | |
| 11 | + | |
12 | 12 | | |
13 | 13 | | |
14 | 14 | | |
| |||
59 | 59 | | |
60 | 60 | | |
61 | 61 | | |
62 | | - | |
| 62 | + | |
63 | 63 | | |
64 | 64 | | |
65 | 65 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
1 | 9 | | |
2 | 10 | | |
3 | | - | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
4 | 27 | | |
5 | 28 | | |
6 | | - | |
| 29 | + | |
7 | 30 | | |
8 | 31 | | |
9 | 32 | | |
10 | | - | |
11 | | - | |
12 | | - | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
13 | 49 | | |
14 | | - | |
15 | | - | |
16 | | - | |
17 | | - | |
| 50 | + | |
| 51 | + | |
18 | 52 | | |
19 | 53 | | |
20 | | - | |
21 | | - | |
22 | | - | |
| 54 | + | |
23 | 55 | | |
24 | 56 | | |
25 | 57 | | |
| |||
0 commit comments