Skip to content

Fix mintlify validate errors#367

Merged
claude-code-best merged 1 commit intoclaude-code-best:mainfrom
Eric-Guo:main
Apr 26, 2026
Merged

Fix mintlify validate errors#367
claude-code-best merged 1 commit intoclaude-code-best:mainfrom
Eric-Guo:main

Conversation

@Eric-Guo
Copy link
Copy Markdown
Contributor

@Eric-Guo Eric-Guo commented Apr 26, 2026

Summary by CodeRabbit

  • Documentation
    • Enhanced formatting and rendering across multiple guides and examples to improve clarity. Updated command syntax displays, code formatting, and link representations to prevent rendering issues and increase readability.

Copilot AI review requested due to automatic review settings April 26, 2026 01:37
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 26, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 56d8df2e-dd69-4e58-bd3b-e4111831e113

📥 Commits

Reviewing files that changed from the base of the PR and between 901628b and 66a1ea9.

📒 Files selected for processing (5)
  • README_EN.md
  • docs/features/pipes-and-lan.md
  • docs/lsp-integration.md
  • learn/phase-2-qa.md
  • teach-me/learner-profile.md

📝 Walkthrough

Walkthrough

Multiple documentation files receive formatting updates to improve markdown and HTML rendering consistency. Changes include HTML-escaping special characters for safe rendering, wrapping type definitions in inline code, adjusting URL and string representations, and escaping delimiters.

Changes

Cohort / File(s) Summary
HTML-Escape Formatting
docs/features/pipes-and-lan.md, teach-me/learner-profile.md
Replace unescaped angle-bracket placeholders and delimiters with HTML-escaped equivalents (<, >, <->) to prevent misinterpretation in rendered output.
Type & Code Formatting
docs/lsp-integration.md, learn/phase-2-qa.md
Wrap type definitions (Record<string, string>) in inline code blocks and adjust string representation formatting in documentation examples.
URL Format
README_EN.md
Update DeepWiki documentation link from angle-bracket-wrapped format to plain URL text.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Suggested reviewers

  • KonghaYao

Poem

A rabbit hops through docs with care,
Escaping brackets here and there,
With tildes, quotes, and formatting true,
The markdown now displays just so. 🐰✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'Fix mintlify validate errors' directly describes the main objective of the PR: fixing validation errors reported by the mintlify tool across multiple documentation files.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR addresses mintlify validate failures by adjusting Markdown/MDX-unsafe syntax (e.g., raw <...> and {...} fragments) so documentation renders and validates correctly in Mintlify.

Changes:

  • Escapes or code-wraps MDX-sensitive tokens like <name> and {"file_path": to prevent parsing/validation errors.
  • Adjusts type formatting in a schema table to avoid <...> being interpreted as HTML/JSX.
  • Tweaks external link formatting to avoid MDX autolink issues.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
teach-me/learner-profile.md Escapes <-> sequence to avoid MDX/HTML parsing issues.
learn/phase-2-qa.md Wraps a JSON fragment containing { in code formatting to avoid MDX expression parsing.
docs/lsp-integration.md Wraps Record<string, string> in code formatting inside a table for safer rendering.
docs/features/pipes-and-lan.md Escapes <name> placeholders in command references to avoid MDX/HTML parsing.
README_EN.md Removes MDX-problematic <https://...> autolink formatting.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +148 to +149
/pipes select &lt;name&gt; — 选中某实例(消息会广播到它)
/pipes deselect &lt;name&gt; — 取消选中
Copy link

Copilot AI Apr 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In this fenced code block, replacing placeholders with HTML entities (&lt;name&gt;) will typically render literally (as &lt;name&gt;) because code blocks don’t decode entities the same way normal Markdown text does. This makes the example harder to read/copy. Consider keeping the code block examples as /pipes select <name> and only escaping placeholders in non-code contexts (e.g., headings), or use inline code/backticks there to avoid MDX parsing.

Suggested change
/pipes select &lt;name&gt; — 选中某实例(消息会广播到它)
/pipes deselect &lt;name&gt; — 取消选中
/pipes select <name> — 选中某实例(消息会广播到它)
/pipes deselect <name> — 取消选中

Copilot uses AI. Check for mistakes.
Comment thread README_EN.md

- **Online docs (Mintlify)**: [ccb.agent-aura.top](https://ccb.agent-aura.top/) — source in [`docs/`](docs/), PR contributions welcome
- **DeepWiki**: <https://deepwiki.com/claude-code-best/claude-code>
- **DeepWiki**: https://deepwiki.com/claude-code-best/claude-code
Copy link

Copilot AI Apr 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To keep this as an explicit hyperlink across Markdown renderers (and consistent with README.md), consider using standard link syntax like [DeepWiki](https://deepwiki.com/claude-code-best/claude-code) rather than a bare URL. This also avoids the MDX/JSX ambiguity that the previous <...> autolink had.

Suggested change
- **DeepWiki**: https://deepwiki.com/claude-code-best/claude-code
- **DeepWiki**: [deepwiki.com/claude-code-best/claude-code](https://deepwiki.com/claude-code-best/claude-code)

Copilot uses AI. Check for mistakes.
@claude-code-best claude-code-best merged commit 4591432 into claude-code-best:main Apr 26, 2026
6 of 7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants