Skip to content

docs(enterprise): reorganize enterprise nav - #1019

Open
jlav wants to merge 6 commits into
mainfrom
jl/enterprise-nav
Open

jlav wants to merge 6 commits into
mainfrom
jl/enterprise-nav

Conversation

@jlav

@jlav jlav commented Oct 27, 2026 •

Copy link
Copy Markdown
Member
  • I have read and reviewed the documentation changes to the best of my ability.
  • If the change is significant, I have run the documentation site locally and confirmed it renders as expected.

Summary of changes

The Enterprise sidebar is long and hard to navigate. This splits it into Get Started, Deployment, Configuration, Integrations, Features, and Administration, with related pages in collapsed groups.

Deployment starts with the sizing guide, then Kubernetes, VM Install, and Compose (tagged Experimental). In the Kubernetes group, the cloud provider guides, Sysbox, and DNS and TLS come before Install with Helm, since the install guide lists them as prerequisites.

Long page titles get a shorter sidebarTitle so labels fit on one line.

.agents/skills/code-review.md also gets an Enterprise section and a "Make the reader the actor" guideline, so reviews follow the same guidance on deployment positioning, tone, and navigation.

Before and after

Before After
Enterprise sidebar before Enterprise sidebar after

@jlav
jlav added this pull request to stack #1020 October 27, 2026 13:18
@mintlify

mintlify Bot commented Oct 27, 2026 •

Copy link
Copy Markdown

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

Project Status Preview Updated
all-hands-ai 🟢 Ready View Preview Nov 3, 2026, 1:09 PM

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

@jlav jlav changed the title jl/enterprise nav docs(enterprise): reorganize enterprise nav Oct 27, 2026
@jlav jlav mentioned this pull request Oct 27, 2026
2 tasks
@jlav
jlav marked this pull request as ready for review November 3, 2026 13:51
@rajshah4

rajshah4 commented Nov 3, 2026

Copy link
Copy Markdown
Member

Thanks for organizing this, Joe! I’m also working on Enterprise secrets management docs in #1056, covering storage, organization-wide secrets, and a link to the AWS secrets sync cookbook. Could you account for that page in the navigation redesign?

@jlav

jlav commented Nov 3, 2026

Copy link
Copy Markdown
Member Author

@rajshah4 With the new layout, I would move your docs under "Features". Will have to rebase one PR or the other depending on which gets merged first.

This branch was successfully deployed

1 active (outdated) deployment
staging — 3258adc2 Deployed Nov 3, 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.

2 participants