Skip to content

refactor(docs): shorten Core-flow filename, add mermaid support, translate english version#133

Merged
JusterZhu merged 1 commit into
mainfrom
docs/core-execution-flow
Jun 21, 2026
Merged

refactor(docs): shorten Core-flow filename, add mermaid support, translate english version#133
JusterZhu merged 1 commit into
mainfrom
docs/core-execution-flow

Conversation

@JusterZhu

Copy link
Copy Markdown
Collaborator

Summary

Three fixes for the Core-execution-flow documentation page:

1. Shorten filename

Core-execution-flow.mdCore-flow.md — too long, now concise.

2. Add Mermaid flowchart support

The page contains 11 mermaid/flowchart diagrams but they rendered as plain text because Docusaurus was not configured for mermaid.

  • Installed @docusaurus/theme-mermaid
  • Added markdown: { mermaid: true } and themes: ['@docusaurus/theme-mermaid'] to docusaurus.config.js

3. Translate English version

The English i18n file was identical to the Chinese original. Fully translated all sections, mermaid labels, code comments, tables, and TOC anchors.

Files changed

File Change
website/docs/doc/Core-flow.md Renamed (from Core-execution-flow.md)
website/i18n/en/.../Core-flow.md Renamed & fully translated to English
website/sidebars.js Updated doc reference
website/docusaurus.config.js Added mermaid theme config
website/package.json Added @docusaurus/theme-mermaid dependency

🤖 Generated with Claude Code

Copilot AI review requested due to automatic review settings June 21, 2026 04:37

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Refactors the “Core execution flow” documentation by renaming it to a shorter filename, enabling Mermaid rendering in the Docusaurus site, and providing a fully translated English i18n version of the page.

Changes:

  • Added Mermaid support to the Docusaurus configuration and dependencies.
  • Updated the docs sidebar to include the renamed Core flow document.
  • Added the new Core-flow documentation in both zh-Hans and en locales (English translated).

Reviewed changes

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

Show a summary per file
File Description
website/sidebars.js Adds the new doc/Core-flow entry to the Components sidebar.
website/package.json Adds @docusaurus/theme-mermaid dependency for Mermaid rendering.
website/docusaurus.config.js Enables Mermaid in markdown and registers the Mermaid theme.
website/docs/doc/Core-flow.md Adds/renames the Core flow documentation (zh-Hans) with Mermaid diagrams.
website/i18n/en/docusaurus-plugin-content-docs/current/doc/Core-flow.md Adds/renames the English i18n version and translates the full document content.

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

Comment thread website/package.json
Comment on lines 17 to 20
"@docusaurus/core": "3.1.1",
"@docusaurus/preset-classic": "3.1.1",
"@docusaurus/theme-mermaid": "^3.1.1",
"@mdx-js/react": "^3.0.0",
| 步骤 | 文件 | 关键行 |
|------|------|--------|
| 入口分发 | `Bootstrap/GeneralUpdateBootstrap.cs` | `LaunchAsync()` @L125 |
| Upgade 路径 IPC 读取 | `Bootstrap/GeneralUpdateBootstrap.cs` | `InitializeFromEnvironment()` @L357 |
…slate english version

- Rename Core-execution-flow.md to Core-flow.md (short filename)
- Install @docusaurus/theme-mermaid and enable mermaid in config
- Translate english Core-flow.md from Chinese to English
- Fix TOC anchor IDs for English version

Co-Authored-By: Claude <noreply@anthropic.com>
@JusterZhu JusterZhu force-pushed the docs/core-execution-flow branch from e2e412a to 2cda306 Compare June 21, 2026 04:41
@JusterZhu JusterZhu merged commit 107fe39 into main Jun 21, 2026
2 checks passed
@JusterZhu JusterZhu deleted the docs/core-execution-flow branch June 21, 2026 04:44
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.

2 participants