Migrar desde Document360

Exporta un proyecto de Document360 como ZIP y luego convierte sus workspaces, idiomas, categorías y artículos en un proyecto de Mintlify. Usa la API de Document360 y el sitio publicado para auditar el contenido que la exportación puede no representar por completo. Antes de exportar, crea una copia de seguridad manual con nombre en Document360. Ve a Settings > Knowledge base portal > Backup & Restore. Descarga una exportación del proyecto para la migración en sí. En Document360, ve a Content tools > Import and export > Import and export project.

1. Haz clic en Export project.
2. Selecciona el formato de exportación. Elige JSON para una exportación completa del proyecto.
3. En Include new or modified articles in, selecciona All para que la exportación no se limite a los artículos modificados recientemente.
4. Selecciona cada workspace, idioma, categoría y subcategoría que mantengas.
5. Selecciona Include media files.
6. Haz clic en Export. La exportación se ejecuta en segundo plano y te avisa cuando está lista.
7. Descarga el ZIP desde Recent files en cuanto esté listo. Cada nueva exportación sobrescribe el ZIP anterior.
8. Exporta la lista All articles como CSV. Esta lista de metadatos es útil para conciliar títulos, estado de publicación, fechas, categorías y URLs.

Registra las funcionalidades del proyecto que requieren un trabajo de migración por separado.

• Contenido y navegación del Homepage Builder
• Páginas personalizadas enlazadas desde la cabecera, el pie de página o la barra lateral
• Snippets, variables, términos del glosario y plantillas
• CSS personalizado, JavaScript e integraciones
• Grupos de lectores, roles, SSO y reglas de contenido privado
• Reglas de redirección y dominios personalizados
• Analítica, feedback, formularios y configuración de búsqueda
• Especificaciones fuente de la referencia de API
• Archivos de Drive, árboles de decisión y contenido embebido

Usa el sitemap publicado y la Customer API de Document360 para comparar la exportación con el contenido público y privado. La API es especialmente útil cuando necesitas recorrer los metadatos de categorías o recuperar campos difíciles de derivar de los archivos exportados. Asocia la jerarquía de Document360 a docs.json. Elige la asignación de los workspaces en función de cómo los usan tus lectores. Un workspace llamado v1 suele ser una versión, mientras que los knowledge bases de productos distintos pueden asociarse mejor a productos o pestañas. Consulta Navegación para más información sobre los elementos de navegación de Mintlify. Las respuestas de la API de categorías de Document360 incluyen solo los hijos directos. Si usas la API para crear un inventario, solicita cada categoría hija de forma recursiva y recupera el contenido por separado para las categorías de tipo índice y de tipo página. Copia los artículos Markdown a archivos .mdx y convierte el HTML o JSON exportado a MDX. Añade frontmatter con al menos un title, y conserva las descripciones, palabras clave, metadatos de publicación y rutas canónicas cuando resulten útiles. Revisa la salida específica de cada editor: Tanto Document360 como Mintlify renderizan el frontmatter title como el H1 de la página, por lo que el cuerpo de la página empieza en H2. No añadas un H1 duplicado durante la conversión. Inventaría las variables, snippets, términos del glosario y cada uso antes de sustituirlos.

• Convierte los bloques de contenido reutilizable en snippets de Mintlify.
• Sustituye las variables por texto explícito, contenido generado u otra fuente de verdad mantenible.
• Sustituye los tooltips de glosario por enlaces o componentes de tooltip compatibles.
• Conserva las variaciones específicas por idioma en lugar de consolidar texto que solo parece idéntico en un idioma.

Consulta el sitio fuente renderizado además de la exportación para determinar si cada elemento reutilizable aparece como contenido expandido o como una referencia específica de la plataforma. Descarga el archivo OpenAPI original de cada categoría de referencia de API de Document360 o recupéralo del sistema que sincroniza la especificación.

1. Añade la especificación original al repositorio de Mintlify.
2. Configura las páginas generadas a partir de OpenAPI.
3. Conserva las descripciones o ejemplos personalizados de endpoint que los editores hayan añadido tras la importación.
4. Compara la jerarquía de etiquetas, el orden de los endpoints, los servidores, la autenticación, los ejemplos y los code samples.
5. Sustituye cualquier automatización de resincronización de Document360 por el flujo de despliegue de Mintlify.

No conviertas los artículos de endpoints generados cuando la especificación fuente esté disponible. Incluye los medios en la exportación del proyecto y copia los archivos que te pertenezcan a tu repositorio de proyecto de Mintlify. Revisa los enlaces del Drive de Document360, miniaturas, SVG, archivos descargables, imágenes de fondo CSS y contenido embebido desde servicios externos. Actualiza las rutas de los recursos después de reorganizar las páginas. No dejes recursos requeridos en producción en dominios de Document360 a menos que pienses mantener ese hosting activo. Las rutas de Document360 pueden incluir slugs de workspace e idioma, además de slugs de categoría y artículo. Crea un mapa de URLs a partir del sitemap publicado y del CSV de artículos exportado, y añade redirecciones para cada ruta que cambie. Recrea la documentación privada con autenticación y control de acceso. Crea grupos de lectores y restricciones basadas en roles que reflejen tu configuración de control de acceso anterior. Prueba como cada grupo antes de publicar tu sitio. Comprueba que tu ZIP exportado, el CSV de artículos, el inventario de API y el sitemap publicado están alineados, y luego prueba el cambio de idioma y cada selector de workspace. Busca en tus archivos convertidos contenido de Document360 sin convertir: HTML sin procesar, referencias a snippets y variables, notas privadas y embeds de widgets.

​

Lanza tu nuevo sitio

• Establece una congelación de contenido en tu sitio anterior y registra cada cambio que se le realice después de la instantánea de migración.
• Confirma tu rama y repositorio de producción en la página de ajustes de Git de tu panel.
• Anota tus registros DNS actuales y mantén tu sitio anterior en funcionamiento hasta que verifiques que tu despliegue de Mintlify está en producción.
• Revisa la barra de navegación, el pie de página, el favicon, el logotipo, los colores y la tipografía.
• Revisa los metadatos del sitio y de las páginas, las URL canónicas y las preferencias de indexación. Consulta SEO y ajustes de búsqueda.
• Instala las integraciones de analítica necesarias y, opcionalmente, añade una página 404 personalizada.
• Si migraste una referencia de API, compara las páginas de endpoints, la estructura de navegación, las URL de servidor, los esquemas de autenticación y los ejemplos con tu sitio anterior.
• Previsualiza tu commit exacto de lanzamiento en un despliegue de previsualización. Comprueba los diseños en escritorio y móvil, páginas de cada sección de navegación, la búsqueda y tus redirecciones.
• Revisa la consola del navegador y la pestaña de red por si hay errores en páginas que utilicen componentes o scripts personalizados.
• Cambia tu dominio siguiendo la guía de dominio personalizado, que cubre la migración sin tiempo de inactividad para un dominio que ya sirve documentación.
• Tras el lanzamiento, monitorea los errores 404, los fallos de redirección y los fallos de compilación.

• Exportar un ZIP de proyecto
• Exportar todos los artículos
• Copia de seguridad y restauración
• Workspaces e idiomas
• Editor Markdown
• Snippets
• Gestión de referencias de API
• API de categorías
• Páginas personalizadas