Prune bot: fold what-is-mintlify and dashboard/permissions into stronger pages - #6984
Merged
Conversation
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
ethanpalm
approved these changes
Aug 14, 2026
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
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.
Summary
Consolidates two redundant pages that overlap with newer or better-scoped neighbors, in the 8/6-8/14 review window.
/what-is-mintlifyinto/reference/conceptswhat-is-mintlify.mdx(+ es/fr/zh); nav indocs.json+es.json/fr.json/zh.jsonreference/concepts.mdx, which covers the same "how Mintlify works" explanation more thoroughly;what-is-mintlifyhad no inbound prose links./dashboard/permissionsinto/dashboard/rolesdashboard/permissions.mdx(+ es/fr/zh);dashboard/roles.mdx(+ es/fr/zh); nav in all four config filesChanges
what-is-mintlify.mdxin en/es/fr/zh and removed it from the Learn → Overview group indocs.json/es.json/fr.json/zh.json. Added redirects from/what-is-mintlify(and the localized variants) to/reference/concepts.dashboard/permissions.mdxin en/es/fr/zh and removed it from the Security group in all four navigation configs. Its two paragraphs are now a new Repository contributors and deployments section insidedashboard/roles.mdx(translated in es/fr/zh), sitting after the roles matrix. Updated the existing/advanced/dashboard/permissionsredirects, and added new/dashboard/permissionsredirects, to point at that section on the roles page.mint validateandmint broken-links— both pass.Also worth reviewing
Lower-confidence candidates left untouched so a human can triage:
analytics/index,assistant,search,traffic,user-engagements,export,streaming) — landed 8/12 (Split analytics page into a group #6944). Several of the new pages are 30–45 lines and could arguably re-consolidate, but the split is intentional and recent, and each page now has its own SEO description. Recommend waiting a release or two to see how traffic distributes before undoing it.ai/slack-bot.mdx— the page is marked deprecated at the top and is not indocs.jsonnavigation, butguides/knowledge-base.mdx(en/es/fr/zh) still links to it from prose as a live recommendation. Either drop the link and redirect the page, or unmark it as deprecated — the current mixed signal is confusing.dashboard/security-contact.mdx— 15-line stub that mostly says "go to the Security contact settings page." Could fold into an SSO/security parent page, but there is no obvious single owner and it is Enterprise-gated, so the standalone page may be intentional for discoverability.guides/index.mdxvsguides/help-center.mdx/guides/knowledge-base.mdx/guides/developer-documentation.mdx/guides/custom-frontend.mdx— the "Use cases" cluster is coherent but the landing page overlaps with each individual use-case page's intro. Worth a scoped audit.Notes for reviewers
dashboard/roles.mdxis a straight lift of the two paragraphs that were ondashboard/permissions.mdx, lightly re-ordered so the general rule comes first and the editor/admin behavior follows. The redirects for/dashboard/permissions(and its Chinese variant) land on the roles page (Chinese hits the page root because the localized anchor slug wasn't verified end-to-end).Note
Low Risk
Documentation-only consolidation with redirects; no application or security logic changes.
Overview
Removes two thin, overlapping docs pages and folds their content into neighbors, with redirects and nav updates across en, es, fr, and zh.
/what-is-mintlifyis deleted from all locales and dropped from the Learn → Overview nav indocs.jsonand locale JSON configs. Traffic is redirected to/reference/concepts(and localized equivalents)./dashboard/permissionsis deleted and removed from the Security nav group. Its repo-vs-dashboard deployment explanation moves into a new Repository contributors and deployments section ondashboard/roles(with translated headings and anchor IDs in es/fr/zh). Redirects from/dashboard/permissions,/advanced/dashboard/permissions, and locale variants now targetroles#repository-contributors-and-deployments.Reviewed by Cursor Bugbot for commit 225c436. Bugbot is set up for automated code reviews on this repo. Configure here.