Skip to content

Documentation quality check: clarify group rule validation - #7564

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
docs-quality-check-2026-09-29
Open

mintlify[bot] wants to merge 1 commit into
mainfrom
docs-quality-check-2026-09-29

Conversation

@mintlify

@mintlify mintlify Bot commented Sep 29, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Fixes gaps in the include and exclude groups page found during review of English MDX changes from 2026-09-28 to 2026-09-29.

Changes

deploy/exclude-groups.mdx

  • Gap: The beta note said deployments fail whenever the rule form is used, which contradicts the rest of the page. Fix: Deployments now fail only until Mintlify enables rules for the deployment. This matches the server message groups rules with includes or excludes are not enabled for this deployment.
  • Gap: The page didn't say what happens when a groups value is invalid. Fix: Added that Mintlify fails the deployment, doesn't update the site, and lists each affected page path.
  • Gap: The examples table included groups: [], but the page never explained it. Fix: The validation rules now say groups: [] denies access to everyone. This matches the schema message in auth-edge/page-groups.ts.

Evaluated with no gaps found

  • The other changed pages had small additions or style-only edits: desktop.mdx, ai/mintlify-mcp.mdx, assistant/use.mdx, analytics/assistant.mdx, analytics/savings.mdx, editor/review.mdx and deploy/preview-deployments.mdx. Other pages only changed wording, such as "sign in" and "click". Each page still answers its core reader questions.

Open gaps

  • deploy/preview-deployments.mdx: I couldn't check the Auth override dashboard labels in the reference repos, so I left them unchanged.

Note

Low Risk
Documentation-only wording; no runtime or deployment logic changes in this diff.

Overview
Updates deploy/exclude-groups.mdx so the closed-beta note matches product behavior: deployments fail on rule-form groups only until Mintlify enables the feature for the deployment, not for the entire beta period.

The validation rules section now documents that groups: [] denies everyone, and adds explicit deployment failure behavior when any page has an invalid groups value (no site update; error lists affected paths).

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

@mintlify

mintlify Bot commented Sep 29, 2026 •

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated
mintlify 🟢 Ready View Preview Sep 29, 2026, 10:10 AM

This branch was successfully deployed

1 active deployment
staging — ab3f69c8 Deployed Sep 29, 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.

0 participants