Skip to content

docs: group the Agent section by job - #8596

Closed
ethanpalm wants to merge 1 commit into
mainfrom
docs/agent-nav-ia
Closed

ethanpalm wants to merge 1 commit into
mainfrom
docs/agent-nav-ia

Conversation

@ethanpalm

@ethanpalm ethanpalm commented Nov 18, 2026 •

Copy link
Copy Markdown
Collaborator

Fourth PR in the job-based IA pass (after #8593, #8594, #8595).

The Agent group was a flat list with Automations nested in the middle. It's now grouped by what people come to do:

  • Overview and Slack stay at the top
  • Automate maintenance: Autopilot, then the Automations pages
  • Connect your tools: Integrations and Self-hosted GitLab OAuth. Both used to sit inside Automations, but they set up connections the agent uses in Slack and during automation runs.
  • Get better results: Customize with AGENTS.md, effective prompts, use cases

The agent overview's next steps also gain an Autopilot card.

No URLs changed. Autopilot still lives at /autopilot. Moving it under agent/ would need redirects, and the URL works fine as it is.

Checks

  • mint broken-links: no broken links
  • Vale: no findings on changed lines

🤖 Generated with Claude Code


Note

Low Risk
Documentation navigation and one overview card only; no routes, redirects, or product behavior changes.

Overview
Reorganizes the Agent sidebar in docs.json from a flat list into task-oriented groups while keeping all page URLs the same.

Automate maintenance now leads with Autopilot, then a nested Automations section (create, manage, reference only). Connect your tools pulls automations/integrations and deploy/gitlab-self-hosted out of the Automations subtree. Get better results groups customize, effective prompts, and use cases.

The agent overview Next steps section adds a card linking to Autopilot for keeping docs current after merged code changes.

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

- Automate maintenance: Autopilot and automations
- Connect your tools: integrations and self-hosted GitLab OAuth, which
  were inside Automations but apply to the agent generally
- Get better results: AGENTS.md, prompts, and use cases
- Add an Autopilot card to the agent overview's next steps

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Nov 18, 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 18, 2026, 10:56 PM

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

This branch was successfully deployed

1 active deployment
staging — c627b2e7 Deployed Nov 18, 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