Skip to content

Conversation

@nearestnabors
Copy link
Contributor

No description provided.

nearestnabors and others added 5 commits December 4, 2025 16:22
This commit implements a complete restructuring of the Nextra documentation
sidebar navigation to match the provided mockup specification. Key changes:

Major Structural Changes:
- Reorganized content into clear sections: Get Started, Example agents, Guides, Learn, Updates, APIs & SDKs
- Renamed directories (using-tools → calling-tools, orchestrators → agent-frameworks, scaling → sharing-with-end-users)
- Created proper hierarchical structures for all major sections

Navigation Cleanup:
- Removed duplicate navigation entries caused by page.mdx files in directories with subdirectories
- Fixed auto-discovery issues by explicitly hiding unwanted directories
- Eliminated "orchestrators" references and created clean agent-frameworks structure
- Removed extra items like "Auth Providers", "Scaling", "migrate mcp" from various sections

Section-Specific Improvements:
- Calling tools: Organized into 3rd party apps, custom apps, triggers, and reference sections
- Creating tools: Restructured into 7 major subsections with proper nesting
- Deployment & Hosting: Converted from single link to proper subsection structure
- Security & Compliance: Cleaned up to show only 3 specified items
- Customizing Auth: Fixed order and removed duplicates, added OAuth 2.0 properly
- Learn: Added proper subsections to "What's an agent?" and cleaned up duplicates
- Arcade Clients: Removed duplicates and standardized to 3 clients

Technical Implementation:
- Updated all _meta.tsx files to match new structure
- Created proper directory hierarchies with placeholder content
- Added comprehensive hidden directory list to prevent auto-discovery issues
- Maintained proper Nextra navigation patterns throughout

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
@vercel
Copy link

vercel bot commented Dec 11, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
docs Ready Ready Preview, Comment Dec 18, 2025 0:24am

nearestnabors and others added 4 commits December 11, 2025 12:39
- Convert "Example agents" section from separate pages to single unified page
- Move example agents from standalone section to under "Getting Started"
- Combine confluence-jira-example and daily-digest-example into one page
- Remove old individual example agent directories and pages
- Update sidebar navigation to show "Example Agents" as single link

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
Update section and page titles throughout the navigation to be more consistent:

Main section changes:
- "Calling tools" → "Call tools"
- "Creating tools" → "Create tools"
- "Sharing your agent with end-users" → "Share your agent with end-users"
- "APIs & SDKs" → "APIs"

Subsection updates:
- "Tool building basics" → "Build a tool"
- "Evaluating tools" → "Evaluate tools"
- "Building tools to get more performance..." → "Improve an existing toolkit"
- "Error Handling"/"Error handling" → "Handle errors"
- "Triggers" → "Trigger tool calls"
- "Customizing Auth" → "Customize auth"

Page title normalization:
- Remove "-ing" suffixes for consistency (Connecting → Connect)
- Use imperative mood throughout (Set up, Configure, etc.)
- Add Java Client page placeholder

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
Update the main navigation section title from "APIs" to "API Reference"
to better reflect the content and align with standard documentation conventions.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Add "Toolkits" as external link to "/en/mcp-servers" in Get Started section
- Change "API key" to "Get an API key" for clarity and consistency

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
nearestnabors and others added 5 commits December 17, 2025 23:33
- Rename all agent framework quickstarts to set-ups:
  - Updated directory names from quickstart-* to set-up-*
  - Changed page titles to "Set up Arcade with FRAMEWORK (Language)"
  - Updated navigation to show "Set up with Python/TypeScript"

- Restructure observability section:
  - Rename observability-platforms to observability
  - Add overview page with comprehensive content
  - Create expandable "Platforms" subsection

- Move Auth Providers to Reference section:
  - Relocated from hidden to visible under Reference
  - Renamed to "Auth Providers"

- Clean up duplicate and unused directories:
  - Remove changelog-page (keep only changelog)
  - Remove status-page (served elsewhere)
  - Remove blog (served elsewhere)

- Update main navigation references to use canonical names

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Remove blog, changelog-page, and status-page directories completely
- Add observability section with overview and platforms structure
- Update main navigation to reference correct directories
- All agent framework quickstarts renamed to set-ups with language-specific titles

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
Navigation Changes:
- Rename "Toolkits" → "Tools" with comprehensive overview page
- Rename "Share your agent with end-users" → "User-facing agents"
- Move Arcade CLI from Configure Arcade to References section
- Update quickstart titles to be more specific

Section Restructuring:
- Remove "Customize auth" and replace with "Configure an OAuth provider" and "Brand your Auth flow"
- Remove "Create organization" from Configure Arcade section
- Remove trigger tool calls section, move "Schedule tool executions" after "Handle errors"
- Update "Add your tools to Arcade's catalog" section with reordered sub-navigation

Content Updates:
- Create Tools overview page with links to catalog, building tools, and contributing
- Add OAuth provider configuration page with comprehensive content
- Update all navigation titles for consistency and clarity
- Simplify "Set up secure multi-user auth" title

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
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