Skip to content

Sync README: add English README, rewrite Chinese README#12

Merged
nevstop merged 1 commit intodev_0.3from
copilot/sync-readme-en-ch
Mar 30, 2026
Merged

Sync README: add English README, rewrite Chinese README#12
nevstop merged 1 commit intodev_0.3from
copilot/sync-readme-en-ch

Conversation

Copy link
Copy Markdown

Copilot AI commented Mar 30, 2026

The repo only had a Chinese README with no English counterpart, and the Chinese prose was verbose and inconsistent in structure.

Changes

  • README.md — Converted to English, following the same style as Communicable-State-Machine: language switcher, GitHub releases badge, concise intro, hyperlinked dependencies, and clean feature sections.
  • README(zh-cn).md — New Chinese README mirroring the English structure exactly; prose rewritten to be more natural and concise.

Structure (both files)

  • Language switcher [English] | [中文] at top
  • GitHub releases badge
  • Project overview + component list
  • Dependencies (with links)
  • Features: Script Execution · Return Value Capture · Extended Commands · Anchors & Jumps

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 synchronizes the repository documentation by making README.md an English README and adding a restructured Chinese README that mirrors the English layout, improving accessibility and consistency for bilingual users.

Changes:

  • Converted README.md from Chinese to English with a language switcher, badge, streamlined intro, and reorganized feature/dependency sections.
  • Added README(zh-cn).md with the same structure and rewritten, more concise Chinese prose.

Reviewed changes

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

File Description
README.md Rewritten in English; reorganizes overview, dependencies, and feature documentation.
README(zh-cn).md New Chinese README matching the English structure and sections.

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

Comment thread README.md
- **CSMScript-Lite Library** — A lightweight CSM script execution engine, itself implemented as a CSM module.
- **Engine**: Core execution engine that parses and runs CSM scripts, managing test state and results.
- **UI**: User interface for script management, execution control, and result viewing.
- **App**: A sample application demonstrating how to use the CSMScript library.
Copy link

Copilot AI Mar 30, 2026

Choose a reason for hiding this comment

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

In the component list, "App" is described as demonstrating how to use the "CSMScript" library, but elsewhere the README refers to "CSMScript-Lite Library". This inconsistent naming is likely to confuse users; consider using one consistent library name (e.g., "CSMScript-Lite" / "CSMScript-Engine(Lite)") throughout the README.

Suggested change
- **App**: A sample application demonstrating how to use the CSMScript library.
- **App**: A sample application demonstrating how to use the CSMScript-Lite Library.

Copilot uses AI. Check for mistakes.
Comment thread README.md
### Extended Commands

格式与 CSM 指令类似:`指令 >> 参数`,指令名称大小写不敏感。
CSMScript provides built-in commands beyond the standard CSM command set. The syntax follows the same pattern as CSM: `command >> arguments`. Command names are case-insensitive.
Copy link

Copilot AI Mar 30, 2026

Choose a reason for hiding this comment

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

The "Extended Commands" section says "CSMScript provides built-in commands..." while the repository/project is presented as CSMScript-Lite. Align the product name here with the rest of the README to avoid ambiguity about which component provides these commands.

Suggested change
CSMScript provides built-in commands beyond the standard CSM command set. The syntax follows the same pattern as CSM: `command >> arguments`. Command names are case-insensitive.
CSMScript-Lite provides built-in commands beyond the standard CSM command set. The syntax follows the same pattern as CSM: `command >> arguments`. Command names are case-insensitive.

Copilot uses AI. Check for mistakes.
Comment thread README(zh-cn).md
- **CSMScript-Lite Library** — 轻量级 CSM 脚本执行引擎,其本身也是一个基于 CSM 实现的模块。
- **Engine**:核心执行引擎,负责解析并运行 CSM 脚本,管理测试状态与结果。
- **UI**:用户界面,提供脚本管理、执行控制和结果查看功能。
- **App**:示例应用程序,展示如何使用 CSMScript 库执行脚本。
Copy link

Copilot AI Mar 30, 2026

Choose a reason for hiding this comment

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

“App”条目中写的是“展示如何使用 CSMScript 库执行脚本”,但文档其它位置使用的是“CSMScript-Lite Library/CSMScript-Lite”。建议统一库/产品名称(例如统一为 CSMScript-Lite 或 CSMScript-Engine(Lite)),避免读者误以为是另一个项目。

Suggested change
- **App**:示例应用程序,展示如何使用 CSMScript 库执行脚本
- **App**:示例应用程序,展示如何使用 CSMScript-Lite Library 执行脚本

Copilot uses AI. Check for mistakes.
Comment thread README(zh-cn).md

### 扩充指令

CSMScript 内置了一套超出标准 CSM 命令集的扩充指令,语法与 CSM 指令相同:`指令 >> 参数`,指令名称大小写不敏感。
Copy link

Copilot AI Mar 30, 2026

Choose a reason for hiding this comment

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

“扩充指令”段落以“CSMScript 内置...”开头,但当前仓库/文档标题是 CSMScript-Lite。建议这里也使用一致的名称,明确到底是 CSMScript-Lite(或其 Engine 模块)提供这些扩展指令。

Suggested change
CSMScript 内置了一套超出标准 CSM 命令集的扩充指令,语法与 CSM 指令相同:`指令 >> 参数`,指令名称大小写不敏感。
CSMScript-Lite 引擎模块内置了一套超出标准 CSM 命令集的扩充指令,语法与 CSM 指令相同:`指令 >> 参数`,指令名称大小写不敏感。

Copilot uses AI. Check for mistakes.
@nevstop nevstop marked this pull request as ready for review March 30, 2026 07:58
@nevstop nevstop merged commit c28ecc8 into dev_0.3 Mar 30, 2026
4 checks passed
@nevstop nevstop deleted the copilot/sync-readme-en-ch branch March 30, 2026 07:58
nevstop added a commit that referenced this pull request Mar 31, 2026
* Add new resource files for Utility and global resource strings

- Created Utility.mnu to define menu resources for the Utility module.
- Added global-rc-strings.vi to manage localized strings for the CSM Script Engine (Lite).

* update build spec & version

* docs: 更新README中的图片引用路径

修正README.md中图片引用路径的大小写问题,保持与实际文件名一致

* Sync and rewrite README: add English README.md, create Chinese README(zh-cn).md (#12)

Agent-Logs-Url: https://github.com/NEVSTOP-LAB/CSMScript-Lite/sessions/dcd4976b-e500-4f63-a613-757a664c7338

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: nevstop <8196752+nevstop@users.noreply.github.com>

* trigger workflow

* fix https://github.com/NEVSTOP-LAB/CSMScript-Lite/actions/runs/23787987199/job/69315880268

---------

Co-authored-by: yao0928 <yao.li@emerson.com>
Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
Co-authored-by: nevstop <nevstop@NEVSTOP-LAB>
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