Skip to content

docs: move Agent, Assistant, Authentication and Credits up the left nav - #8652

Open
cdxker wants to merge 1 commit into
mainfrom
denzell/docs-ia-reorder
Open

cdxker wants to merge 1 commit into
mainfrom
denzell/docs-ia-reorder

Conversation

@cdxker

@cdxker cdxker commented Nov 21, 2026 •

Copy link
Copy Markdown
Contributor

Moved Agent, Assistant, Authentication and a new Credits and pricing group up to sit right under Get started in the Documentation tab, and moved Create content to the bottom, in en, fr, es and zh.

clank context (clickme)

Description

Reorders only the left nav. No URLs, page files or redirects change.

  • New order: Get started, Agent, Assistant, Authentication, Credits and pricing, Manage your site, Agent-ready content, Search and SEO, Document APIs, Integrations, Reference, Create content.
  • Authentication moves out of Manage your site and becomes its own top-level group. Its root and pages stay the same.
  • credits moves out of Reference into a new single-page group called "Credits and pricing" (fr "Crédits et tarifs", es "Créditos y precios", zh "积分与定价").

Test Plan

  • mint validate: shows the same 4 import-errors as origin/main (see callout), no new errors.
  • mint broken-links: success no broken links found.
  • Diffed the old and new navigation in all 4 files: same set of pages, Get started group unchanged.

This PR runs alongside the PR that cleans up the Get started group, so it leaves that group's contents as they are.

Detail

  • I couldn't pull page-view data. PostHog exec returned Internal error on every call (project-get, info execute-sql, tools, execute-sql SELECT 1). mint analytics reported not logged in, and this session had no admin API key for /v1/analytics/{projectId}/views.
  • So this order is not backed by data. It is the order Denzell asked for. The groups below the requested ones keep their current relative order.
  • I didn't build the top-30 page-view table or the list of high-traffic pages buried in the lower half of the nav, and I moved no pages within groups. Both need the data.
  • assistant/billing stays in Assistant. It is assistant-specific, and moving it would change the page set this PR touches.
  • The rewrite normalizes some mis-indented lines in Manage your site in docs.json. That is why the diff is larger than the move alone.

Components

docs.json, fr.json, es.json, zh.json

  • The same reorder in each language's Documentation tab. Groups are matched by position and by the deploy/authentication-setup root and credits page, so translated group names are kept.

Warning

Callouts / Workarounds

  • The order isn't backed by page-view data: PostHog returned Internal error and the Mintlify analytics CLI wasn't logged in. The top-30 table and the buried-pages list still need doing.
  • mint validate fails on origin/main too (4.0.1797 and 4.3.81): snippets/recharts-example.jsx and snippets/dithering-example.jsx import npm packages. This PR doesn't fix it because that's outside a nav-only change.
  • "Credits and pricing" is a new group with one page (credits).

Note

Low Risk
Navigation-only JSON reordering with no new routes or content; main risk is discoverability if users expect the old sidebar order.

Overview
Reorders the Documentation tab sidebar in docs.json, fr.json, es.json, and zh.json so Agent, Assistant, Authentication, and a new Credits and pricing section sit directly under Get started, with Create content moved to the bottom.

Authentication is lifted out of Manage your site into its own top-level group (same pages and root). The credits page moves from Reference into the new Credits and pricing group (localized labels in each locale). Page paths and redirects are unchanged; only group order and nesting in navigation config change. The docs.json edit also normalizes indentation under Manage your site and the Learn → Guides menu.

Reviewed by Cursor Bugbot for commit 057e910. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Nov 21, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
Mintlify Docs 🟢 Ready View Preview Nov 21, 2026, 12:26 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

This branch was successfully deployed

1 active deployment
staging — 057e9101 Deployed Nov 21, 2026 by mintlify[bot]
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.

1 participant