Skip to content

[codex] Rename AI onboarding docs to Agent Toolkit#6510

Open
Alek99 wants to merge 1 commit into
mainfrom
codex/agent-toolkit-docs
Open

[codex] Rename AI onboarding docs to Agent Toolkit#6510
Alek99 wants to merge 1 commit into
mainfrom
codex/agent-toolkit-docs

Conversation

@Alek99
Copy link
Copy Markdown
Member

@Alek99 Alek99 commented May 14, 2026

Summary

  • rename the AI onboarding docs page and generated markdown asset to Agent Toolkit, with redirects and a legacy markdown alias for the old slug
  • update AI docs nav, marketing links, llms.txt grouping, and tests to use Agent Toolkit
  • surface the Enterprise Event Handler API Plugin in the Enterprise overview, docs landing page, and sidebar under Plugins

Validation

  • uv run --project docs/app pytest tests/test_agent_files.py tests/test_routes.py
  • git diff --check
  • local docs screenshots captured for Agent Toolkit and Enterprise plugin pages

@Alek99
Copy link
Copy Markdown
Member Author

Alek99 commented May 14, 2026

Proof screenshots from the local docs preview:

@codspeed-hq
Copy link
Copy Markdown

codspeed-hq Bot commented May 14, 2026

Merging this PR will not alter performance

βœ… 24 untouched benchmarks
⏩ 2 skipped benchmarks1


Comparing codex/agent-toolkit-docs (7ca8d91) with main (d6618b2)

Open in CodSpeed

Footnotes

  1. 2 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

Copy link
Copy Markdown
Contributor

@picklelo picklelo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

agent toolkit changes look good.

For the event handler plugin - it was more the discoverability of the page rather than the contents. Let's maybe merge just the agent toolkit changes first and figure out the best UX / naming / search for the event handler plugin

@Alek99 Alek99 force-pushed the codex/agent-toolkit-docs branch from af072f6 to 7ca8d91 Compare May 14, 2026 20:34
@Alek99
Copy link
Copy Markdown
Member Author

Alek99 commented May 14, 2026

Updated this to keep only the Agent Toolkit rename/searchability changes. I removed the Event Handler API Plugin discoverability/content changes from this PR so we can handle that UX/naming/search path separately.\n\nValidation: uv run --project docs/app pytest tests/test_agent_files.py tests/test_routes.py passes (9 passed, same existing pytest config warnings).

@Alek99 Alek99 marked this pull request as ready for review May 14, 2026 22:03
@Alek99 Alek99 requested a review from a team as a code owner May 14, 2026 22:03
@Alek99 Alek99 requested a review from picklelo May 14, 2026 22:03
@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented May 14, 2026

Greptile Summary

This PR renames the "AI Onboarding" docs page to "Agent Toolkit" across all relevant files, including the sidebar, nav, footer, marketing links, llms.txt groupings, and tests. Backward compatibility is preserved via HTTP redirects for the old slugs and a legacy .md content alias.

  • Rename + redirects: ai-onboarding β†’ agent-toolkit with explicit redirects for both the /ai/ and /ai-builder/ variants, and the general /ai/ β†’ /ai-builder/ redirect rule updated accordingly.
  • Legacy markdown alias: LEGACY_MARKDOWN_ALIASES in _plugin.py serves the old .md URL with identical content so agent-facing tooling reading the legacy path still gets the current page.
  • Footer fix: The "Agent Toolkit" footer link was previously pointing to /docs/ai/integrations/overview/ (incorrect); it now correctly points to /docs/ai/integrations/agent-toolkit/.

Confidence Score: 5/5

Safe to merge β€” all old URLs are covered by redirects, the legacy markdown alias preserves agent-facing content at the old path, and tests confirm the new routes and content parity.

The rename is consistent across every touch point: route, sidebar, breadcrumb, footer, nav, llms.txt grouping, and tests. The markdown generator materializes results as a tuple before building the lookup dict so the iterable can be expanded again. The _ordered_sections logic produces the correct AI Builder β†’ Agent Toolkit β†’ MCP β†’ Skills sequence, verified by updated test assertions.

No files require special attention.

Important Files Changed

Filename Overview
docs/app/agent_files/_plugin.py Renames constant from AI_ONBOARDING_DOC_PATHS to AGENT_TOOLKIT_DOC_PATHS, updates llms.txt section label, and adds LEGACY_MARKDOWN_ALIASES to serve the old ai-onboarding.md path with current content.
docs/app/reflex_docs/reflex_docs.py Replaces the old single-expression redirect list with two explicit legacy redirects prepended before the general /ai/ β†’ /ai-builder/ comprehension; no duplicate redirects generated.
docs/app/reflex_docs/templates/docpage/docpage.py Replaces per-segment .capitalize() with a segment_labels dict mapping ai β†’ AI and both toolkit slugs β†’ Agent Toolkit, falling back to to_title_case for other segments.
docs/app/reflex_docs/templates/docpage/sidebar/sidebar.py Renames ai_onboarding_items/index to agent_toolkit_items/index throughout, and updates sidebar category label from MCP/Skills to Agent Toolkit.
docs/app/tests/test_agent_files.py Updates section/title expectations to Agent Toolkit, adds assertion verifying the legacy ai-onboarding.md path serves identical content to agent-toolkit.md.
docs/app/tests/test_routes.py Replaces ai-onboarding route assertions with agent-toolkit, confirms old slug no longer exists as a route.
packages/reflex-site-shared/src/reflex_site_shared/views/footer.py Corrects the Agent Toolkit footer link from /docs/ai/integrations/overview/ to /docs/ai/integrations/agent-toolkit/.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["/ai/integrations/ai-onboarding/"] -->|redirect| C["/ai/integrations/agent-toolkit/"]
    B["/ai-builder/integrations/ai-onboarding/"] -->|redirect| C
    D["/ai-builder/integrations/agent-toolkit/"] -->|redirect - general rule| C
    C --> E["Agent Toolkit doc page"]

    F["ai/integrations/ai-onboarding.md"] -->|legacy alias - same content| G["ai/integrations/agent-toolkit.md"]
    G --> H["llms.txt: Agent Toolkit section"]
Loading

Reviews (1): Last reviewed commit: "Rename AI onboarding docs to Agent Toolk..." | Re-trigger Greptile

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