docs: reposition around "Link" and build complete Mintlify docs system#197
Merged
shuxueshuxue merged 8 commits intomainfrom Apr 4, 2026
Merged
docs: reposition around "Link" and build complete Mintlify docs system#197shuxueshuxue merged 8 commits intomainfrom
shuxueshuxue merged 8 commits intomainfrom
Conversation
…cs system - Rewrite README (EN+ZH): tagline and intro now reflect "Link" positioning (body/mind/memory/social) instead of "enterprise agent runtime" - Add docs/docs.json: Mintlify config with EN/ZH tabs, group icons, global anchors - Replace 6 legacy .md docs with 9 new .mdx pages per language (18 total): introduction, quickstart, concepts, multi-agent-chat, sandbox, memory, configuration, cli, deployment - New pages: quickstart.mdx, concepts.mdx, memory.mdx (not in original docs) - All pages use Mintlify components: Mermaid diagrams, AccordionGroup, Tree, Tabs, CodeGroup, Steps, Columns, CardGroup - Frontmatter: icon, sidebarTitle, keywords on every page - introduction uses mode: wide
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
- docs.json: move anchors from global.anchors to top-level anchors field - cli.mdx: restore missing sandbox delete and destroy-all-sessions commands (EN+ZH) - configuration.mdx: restore merge strategy table for all config domains (EN+ZH) - deployment.mdx: restore Daytona self-hosted section with Docker Compose network config, /etc/hosts setup, and expanded troubleshooting accordion (EN+ZH)
- Delete docs/en/cli.mdx and docs/zh/cli.mdx entirely - Remove cli from docs.json navigation (EN+ZH) - sandbox.mdx: remove CLI commands section, keep API endpoints only - configuration.mdx: replace leonai config wizard with manual file creation; replace leonai --model with models.json example - concepts.mdx: replace leonai thread rewind with generic API description - memory.mdx: remove leonai thread rewind reference - deployment.mdx: remove leonai config and leonai --version/sandbox commands
- anchors -> global.anchors: global.anchors are persistent sidebar links, plain anchors is a different nav pattern (replaces tabs) - Replace languages (FA Pro) with globe (FA Free) - Replace layers (FA Pro) with book-open (FA Free) - Replace sliders with gear (FA Free)
Collaborator
|
@f-2j review this again |
f-2j
requested changes
Apr 4, 2026
Collaborator
f-2j
left a comment
f-2j
left a comment
There was a problem hiding this comment.
Findings (blocking):
- Broken README doc links after .md -> .mdx migration.
README.md:62,173-178links to removed files:docs/en/sandbox.md,docs/en/cli.md,docs/en/configuration.md,docs/en/multi-agent-chat.md,docs/en/deployment.md,docs/en/product-primitives.md.README.zh.md:62,173-178has the same issue fordocs/zh/*.
I verified this on PR head (docs/polish) by checking actual file existence; those paths do not exist.
Impact: users following README hit 404s from the project landing page.
Requested fix:
- Update README links to existing docs targets (
*.mdxor valid new paths). - Replace
product-primitiveswithconcepts. - Either restore CLI docs or remove the CLI entries from both READMEs.
f-2j
previously requested changes
Apr 4, 2026
Collaborator
f-2j
left a comment
f-2j
left a comment
There was a problem hiding this comment.
Re-review result: one blocking regression remains.
The PR migrates docs pages to .mdx, but both top-level READMEs still link to deleted .md files, so these links 404 on GitHub.
Evidence on current PR head (39b5c52):
README.md:62,173-178links todocs/en/*.md(missing)README.zh.md:62,173-178links todocs/zh/*.md(missing)- repository tree contains
docs/en/*.mdxanddocs/zh/*.mdxfor those pages
Please update those links to existing targets (or to Mintlify-hosted URLs) and I will re-review quickly.
…product-primitives -> concepts
Collaborator
Author
|
Fixed: updated all README doc links from deleted |
shuxueshuxue
approved these changes
Apr 4, 2026
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
3 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.
Summary
/docsfor Mintlify deploymentdocs.jsonwith EN/ZH tab navigation, group icons, and global anchors.mdxfiles), including 3 new pages not in the original docs:quickstart,concepts,memory.mdfiles and removed internalmarketplace-architecture.mdAccordionGroup,Tree,Tabs,CodeGroup,Steps,Columns,CardGroupicon,sidebarTitle,keywordson every page;introductionusesmode: wideTest plan
main(configured in dashboard: org=opendcai, repo=Mycel, branch=main, path=/docs)mode: wideapplies to introduction pages