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 Preview Comments Updated (UTC)
docs Ready Ready Preview Comment Dec 12, 2025 0:50am

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>
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