Repository navigation
Conversation
Navigation: - Replace Manage your site with Configure your site, Deploy and host, Reader access, Analytics, and Administer your organization - Separate reader sign-in from dashboard SSO, SCIM, and session security - Move CI checks to Deploy and host and personalization to Reader access - Move Projects to Get started and Knowledge bases to their own group - Add a Custom components subgroup under Components Reader access: - Authentication setup becomes an overview: choose a method, make pages public, feature availability, and encryption at rest - One page each for password, private, OAuth, and JWT authentication - New Control access with groups and User data format pages - Point links at the new pages and fix the Search row link Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
This was referenced Nov 18, 2026
Collaborator
Author
|
@mintlify fix merge conflicts |
# Conflicts: # deploy/authentication-setup.mdx # docs.json
Splitting the AI group in #8597 dropped its icon, so the two new groups were the only Guides groups without one. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Nest the five sign-in methods under Sign-in methods and the analytics pages under Reports and Export, so the sidebar shows 91 rows with nested groups collapsed instead of 102 - Move Knowledge bases right after Create content, ahead of the site-only sections - Use the same short method names in the sidebar and the overview table: Organization members, Emails - Rename the emails page's groups section to Assign readers to groups, keep only the emails-specific parts, and link to the groups page for the access rules Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Applies the job-based IA from the assistant (#8412) and API (#8488) restructures to the "Manage your site" group and the reader authentication docs.
Navigation
"Manage your site" had about 75 pages for four different audiences. It's now five top-level groups:
.mintignore, contextual menu, narration, bring your own modelThis separates reader sign-in from dashboard SSO, SCIM, and session security, which used to share one "Authentication" group.
Also:
Reader access pages
deploy/authentication-setuphad the same shape as the old OpenAPI setup page: four sign-in methods, each with its own prerequisites, setup steps, and example. It's now an overview, and each method has its own page:No URLs were removed, so no redirects are needed. English links to the old section anchors now point at the new pages. The overview's Search row also linked to the assistant page, so I fixed that link.
With nested groups collapsed, the Documentation sidebar shows 91 rows, up from 76 on main. Splitting one group into five adds headers, and the subgroups keep the rest of the growth down.
The emails page's groups section is now Assign readers to groups. It keeps per-reader groups and domain rules, and links to the new groups page for the access rules it used to repeat.
Checks
mint broken-links: no broken linksmint a11y: no issuesAreas of uncertainty
deploy/exclude-groupsstays hidden because it's in closed beta. The groups page doesn't link to it.example.cominstead offoo.com, following the style guide's rule on reserved domains.🤖 Generated with Claude Code
Note
Low Risk
Documentation and navigation only; no application code or authentication behavior changes.
Overview
Reorganizes site-management docs by job and splits reader authentication from one long page into a hub plus focused articles, with navigation in
docs.jsonupdated to match.The former Manage your site section becomes Configure your site, Deploy and host, Reader access, top-level Analytics, and Administer your organization (dashboard SSO/SCIM/security separated from docs sign-in). Projects moves under Get started; Knowledge bases is its own group; Personalization and CI move under Reader access and Deploy respectively.
deploy/authentication-setupis now Control who can read your docs (overview): method comparison with links, public pages, feature availability, and encryption. Setup for password, organization members, OAuth, and JWT lives on new pages; groups and user data format are new shared references. The emails auth page drops duplicated group rules and points at the groups doc.Cross-links across MCP, analytics, CLI, guides, and page frontmatter now target
/deploy/groups,/deploy/user-data-format, and per-method URLs instead of removedauthentication-setupanchors (overview anchors like#make-pages-publicremain). Minor fixes include the auth overview Search row linking to/optimize/searchand examples usingexample.comdomains.Reviewed by Cursor Bugbot for commit fa2ef68. Bugbot is set up for automated code reviews on this repo. Configure here.