Migrate GitBook docs to Mintlify - #1
Open
kaustav98255 wants to merge 1 commit into
Open
Conversation
Convert the Paradime GitBook help docs (paradime-io/gitbook-app-help) into this Mintlify site. Migrates the New-IA pages referenced by SUMMARY.md (Start here, Guides, Products, Integrations, Developers, Get Help, Resources) — 613 pages, 463 assets. - Add scripts/migrate.py: a repeatable GitBook->Mintlify converter (parses SUMMARY.md, converts hint/tabs/code/content-ref/embed/figure/stepper/ include/file/update blocks and GitBook HTML pre/code + data tables + Arcade embeds to Mintlify components, migrates and slugifies assets, rewrites links). - Add scripts/validate.py: network-free structural MDX sanity checks. - Regenerate docs.json: navigation from SUMMARY.md, 1450 redirects (per-page /app-help catch-all + legacy documentation/->products/ remap + ported .gitbook.yaml redirects), Paradime branding. - Componentize developer/API docs: ParamField/ResponseField/CodeGroup. - Replace Mintlify starter demo content; add home page; customize AGENTS.md. - Add MIGRATION_REPORT.md documenting broken links and manual follow-ups. Run `mint dev` and `mint broken-links` locally for the authoritative build. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EKKxjhomFXafR7oL4m7hJL
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Convert the Paradime GitBook help docs (paradime-io/gitbook-app-help) into
this Mintlify site. Migrates the New-IA pages referenced by SUMMARY.md
(Start here, Guides, Products, Integrations, Developers, Get Help, Resources)
— 613 pages, 463 assets.
SUMMARY.md, converts hint/tabs/code/content-ref/embed/figure/stepper/
include/file/update blocks and GitBook HTML pre/code + data tables + Arcade
embeds to Mintlify components, migrates and slugifies assets, rewrites links).
(per-page /app-help catch-all + legacy documentation/->products/ remap +
ported .gitbook.yaml redirects), Paradime branding.
Run
mint devandmint broken-linkslocally for the authoritative build.Co-Authored-By: Claude Opus 4.8 noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_01EKKxjhomFXafR7oL4m7hJL