* 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: 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: update hosted docs domain to mintlify.site
* docs: complete mintlify.site migration across remaining pages
Updates 45 files that PR 6282 had originally changed but were
reverted by PR 6285 and not re-addressed in this PR:
- snippets/vercel-json-generator.mdx (all 4 locales): rewrite
destinations now use mintlify.site, consistent with deploy/vercel.mdx
- assistant/use.mdx: example deep-link URLs
- ai/skillmd.mdx: agent card subdomain reference
- guides/assistant-embed.mdx: docsURL code example
- guides/codex.mdx: MCP URL example
- deploy/authentication-setup.mdx: example Mintlify subdomain
- discovery-openapi.json: domain identifier URL descriptions (4 occurrences)
- integrations/privacy/osano.mdx: managed rule domain
- editor/branching-and-publishing.mdx: branch preview URL format
- customize/themes.mdx: theme demo site links
- guides/help-center.mdx: live example link
- zh/editor/collaborate.mdx: branch preview URL format
All changes mirrored across es, fr, and zh locales.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---------
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 Sonnet 4.6 <noreply@anthropic.com>
mintlify[bot]