Skip to content

Point agents to support and the site index - #8345

Open
mintlify[bot] wants to merge 2 commits into
mainfrom
kyle/point-agents-to-support-and-the-site-index
Open

mintlify[bot] wants to merge 2 commits into
mainfrom
kyle/point-agents-to-support-and-the-site-index

Conversation

@mintlify

@mintlify mintlify Bot commented Nov 7, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Fixes from Ora's agent benchmark on our own docs. 0 of 120 agent runs that entered through the docs llms.txt ever reached the root llms.txt, where support lives. Adds one agent instruction, shown at the top of every markdown page and llms.txt, linking support.md and the root site index.

Also redirects the guessed paths that 404 most in Ora's runs and our CDN logs (ai/mcp and deploy/custom-domain alone are 88% of the flagged events), plus billing, settings/authentication, support and faq. One redirect also covers the .md variant.

Test Plan

  • After merge, the docs llms.txt header shows the new line
  • Each redirected source resolves to a 200

Note

Low Risk
Configuration-only changes (agent instructions and URL redirects) with no application logic or auth changes.

Overview
Adds a global agent instruction in docs.json so coding agents reading any markdown page or docs llms.txt are explicitly directed to Mintlify support (support.md) and the root site index (llms.txt).

Also extends redirects.json with routes that steer common dead-end or legacy URLs to current destinations: MCP and auth/billing paths into the right docs pages, /deploy/custom-domain into customize docs, and /support plus /faq to the public support site.

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

- Updated docs.json

Mintlify-Source: dashboard-editor
@mintlify

mintlify Bot commented Nov 7, 2026 •

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated
Mintlify Docs 🟢 Ready View Preview Nov 7, 2026, 8:18 PM

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

- Updated redirects.json

Mintlify-Source: dashboard-editor

This branch was successfully deployed

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