Ethan Palm 3b2ab685d9 Add migration guides (#6996) ...

* 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>

2026-08-19 10:30:56 -07:00

8.8 KiB

Raw Permalink Blame History

View Raw