* docs: add help center article for private repo missing in second deployment onboarding
* docs: translate second-deployment private repo help article and tighten English title
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
* docs: add help center article for static file 404 troubleshooting
* docs: translate static-file-not-served help center article to es, fr, zh
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
* docs: add platform migration guides
* move migrations.mdx to migrations/index.mdx
* add doc360 and fern guides
* /goal loop
* copy edit index
* copy edit doc 360
* docusaurus copy edits
* fern copy edit
* gitbook copy edit
* copy edit go-live
* resolve TODOs
* manual copy edit
* readme copy edit
* Fix GitBook terminology, Document360 export steps, and revert banner examples
- migration/gitbook.mdx: GitBook renamed spaces to sections. Their current
docs use "section" exclusively across the Git Sync, content-structure,
content-configuration, and reusable-content pages. Update terminology
throughout, add a note about the older name, correct the Git Sync setup
steps to match the real flow (Set up next to Git Sync in the section
header, then pick a provider), and expand the direction warning with the
version-history rollback. Add a Vale.Terms toggle so .gitbook.yaml and
.gitbook/ paths do not trip the GitBook capitalization rule.
- migration/document360.mdx: fix "Document 360" typo and align the export
procedure with Document360's documented dialog order, including the
format selection, the Include media files checkbox, and downloading from
Recent files.
- Revert components/banner.mdx and its es/fr/zh copies. The /migration link
there is a placeholder inside an example, and translated content is
handled by the translation pipeline.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
* Rename migration hub page to avoid duplicating its group name
The group is already called "Migrate to Mintlify", so the root page title
repeated it in the sidebar.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
* Address migration guide nits: Fern paths, scraper page command, placeholders
- migration/fern.mdx: correct the source-content paths against Fern's
documented project structure. Pages live in fern/docs/pages/ and assets in
fern/docs/assets/. Add the previously missing fern/docs/snippets/,
fern/docs/changelog/, and fern/styles.css, note that only the fern and
changelog folder names are reserved, and map Fern snippets to Mintlify
snippets in the component table.
- migration/index.mdx: document the scraper's page command, which was only
documented in the deleted migration.mdx. Covered once here rather than
repeated in each scraper-supported platform guide. Also update the GitBook
card to say section instead of space.
- migration/readme.mdx: replace https://project.readme.io with
https://your-project.readme.io. The former is a real login-gated project.
- migration/docusaurus.mdx: remove trailing whitespace.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
* remove go live checklist
* add launch your site snippet
* update index
* 💅
* 💅
---------
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
* docs: add troubleshooting for OpenAPI URL fetch failures during build
* docs: translate OpenAPI fetch-failure troubleshooting to es/fr/zh
* docs: move OpenAPI fetch diagnostics to first help-center page
Split the troubleshooting accordion: the curated page keeps a complete,
compact answer, and the deep diagnostic walkthrough moves to a new
help-center page that is searchable but excluded from the sidebar.
- Add hidden + searchable "Help center" group to docs.json
- Revert es/fr/zh edits so the translation pipeline regenerates them
- Broaden the allowlist vocabulary entry to cover inflected forms
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
* make help center a hidden tab
* 💅
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
* docs: update custom domain setup for new dashboard flow
Reflect the new custom domain UI: hosting mode selector (domain/subdomain
vs subpath), traffic routing options (Mintlify-managed vs proxy-only),
arbitrary base paths with reserved-path list, and base path changes that
redeploy with rollback on failure. Replace references to the removed
Host at /docs toggle in the Vercel and reverse proxy guides.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
* copy edit
* update images
* docs: update subpath proxy guides for dashboard base paths
Custom subpaths no longer require documentation files to live in a
directory matching the subpath. The base path set in the dashboard is
applied at build time, so the custom subpath reverse proxy setup now
uses the same routing configuration as /docs with the path substituted.
Add dashboard base path setup steps to the Vercel, Cloudflare Worker,
and Route 53/CloudFront guides.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
* 💅
* add plan gate
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
* update vercel generator
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
* remove gate
* remove gate
* Fix review findings: shared subpath setup snippet, generalize /docs framing, clarify Host header and script guidance
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
* Align hosting mode and traffic routing labels with dashboard UI, update screenshot alt text
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
* Fix root-only special file routing: path-preserving nginx destinations, restore sitemap/robots/mcp rewrites, sanitize generator input
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
* Add apex domain DNS provider requirements
Apex domains get the same CNAME instruction as subdomains, but a CNAME
at the apex requires provider support for CNAME flattening or ALIAS
records. Document the requirement and supported providers, and link to
it from the hosting mode section.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
* Correct special-file routing to base-path destinations per live verification, remove stale toggle images, generalize propagation snippet
Verified against mintlify.mintlify.site: all special files (sitemap.xml,
robots.txt, mcp, skill.md, llms.txt) serve under the base path and 404 at
root, so root-mapping rewrites are reverted and optional root routes now
proxy to base-path destinations. Broken links in es/fr/zh from image
deletion resolve via post-merge translation automation.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
* remove outdated images
* Update dashboard instructions for Host at toggle UI (mint #8979)
The hosting mode selector and traffic routing options were replaced with
a Host at toggle and inline base path input; routing is now inferred from
DNS. Verified against mint origin/main commit 6fb20b1789.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
* 💅
---------
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
* docs: move integrations page from agent to automations
Slack agent integrations are deprecated; integrations now serve the
Automations product and are managed from Settings -> Integrations in the
dashboard. Moves /agent/integrations to /automations/integrations with
redirects, reframes the page around automations, and updates links in the
agent and automations pages.
Co-authored-by: Cursor <cursoragent@cursor.com>
* Update automations/integrations.mdx
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
---------
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
* added copy for client export feature
* Fail GitHub Action when export job times out
The sample workflow's wait step previously exited successfully after 60
polls even if the job was still queued/running, then called generate
bundle on an incomplete job (HTTP 409 or a broken deploy). Exit 0 only on
completed, and fail explicitly on timeout.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* update availability callouts
* add missing 400
* 💅
---------
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Co-authored-by: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
* docs(DOC-389): add Codex CLI guide and MCP connection tab
Adds a guide for using OpenAI Codex CLI with Mintlify docs (AGENTS.md
config + MCP connection), adds Codex to the AI tools nav group, and
adds a Codex tab to the MCP server connection example section.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* docs: add Codex to AI tools list in guides index
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* docs: update Windsurf → Devin Desktop across guides and contextual menu
windsurf.com permanently redirects to devin.ai/desktop. Updates:
- guides/windsurf.mdx: rebrand to Devin Desktop, update rules path to
.devin/rules/, update docs links, add MCP config with correct format
- ai/contextual-menu.mdx: replace deprecated "windsurf" identifier with
"devin-desktop" in example config, update description and keywords
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* docs: rename guides/windsurf to guides/devin-desktop, add redirect
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* docs: sweep remaining Windsurf → Devin Desktop references in English docs
Updates ai-native.mdx, guides/index.mdx, guides/claude-code.mdx,
organize/settings-structure.mdx, organize/settings-reference.mdx,
and cli/install.mdx. Changelogs and translation files left as-is
(changelogs are historical records; translations auto-update on merge).
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* docs: add Codex tab to Use your MCP server section
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
* Update docs.json
---------
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
mintlify[bot]