diff --git a/README.md b/README.md
index cd82d45a3..cfcad1f64 100644
--- a/README.md
+++ b/README.md
@@ -8,8 +8,8 @@ Dora SSR is a game engine for rapid development of games on various devices. It
| Category | Badges |
| - | - |
-| Provided Game Dev Tools |   |
-| Supported Languages |       |
+| Provided Game Dev Tools |   |
+| Supported Languages |        |
| Supported Platforms |      |
@@ -45,6 +45,7 @@ Dora SSR is a game engine for rapid development of games on various devices. It
|TypeScript|Supports [TypeScript](https://www.typescriptlang.org), a statically typed superset of JavaScript that adds powerful type checking (with [TSTL](https://typescripttolua.github.io)).|
|TSX|Supports [TSX](https://dora-ssr.net/docs/tutorial/Language%20Tutorial/using-tsx), allows embedding XML/HTML-like text within scripts, used with TypeScript.|
|Rust|Supports the [Rust](https://www.rust-lang.org) language, running on the built-in WASM runtime with [Rust bindings](https://lib.rs/crates/dora-ssr).|
+|Wa|Supports the [Wa](https://wa-lang.org) language, a simple, reliable, and statically typed language running on the built-in WASM runtime with [Wa bindings](https://github.com/IppClub/Dora-SSR/tree/main/Tools/dora-wa).|
|2D Animation|2D skeletal animations support with [Spine2D](https://github.com/EsotericSoftware/spine-runtimes), [DragonBones](https://github.com/DragonBones/DragonBonesCPP) and a builtin system.|
|2D Physics|2D physics engine support with [PlayRho](https://github.com/louis-langholtz/PlayRho).|
|Web IDE|Built-in out-of-the-box Web IDE, providing file management, code inspection, completion, highlighting and definition jump.
|
@@ -133,9 +134,9 @@ Dora SSR is a game engine for rapid development of games on various devices. It
- 2\. Run the software and access the server address displayed by the software through a browser.
- 3\. Start game development.
-### Game engine development
+### Build Game Engine
-For the installation and configuration of Dora SSR project development, see [Official Documents](https://dora-ssr.net/docs/tutorial/dev-configuration) for details.
+- For the building instructions of Dora SSR project, see [Official Documents](https://dora-ssr.net/docs/tutorial/dev-configuration) for details.
diff --git a/README.zh-CN.md b/README.zh-CN.md
index e3e168f4e..579e1161a 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -8,8 +8,8 @@
| 类别 | 徽章 |
| - | - |
-| 提供游戏开发工具 |   |
-| 支持编程语言 |       |
+| 提供游戏开发工具 |   |
+| 支持编程语言 |        |
| 支持运行平台 |      |
@@ -45,6 +45,7 @@
|TypeScript|支持 [TypeScript](https://www.typescriptlang.org) 语言，一门静态类型的 JavaScript 语言的超集，添加了强大的类型检查功能。（通过 [TSTL](https://typescripttolua.github.io)）|
|TSX|支持 [TSX](https://dora-ssr.net/zh-Hans/docs/tutorial/Language%20Tutorial/using-tsx)，允许在脚本中嵌入类似 XML/HTML 的文本，与 TypeScript 一起使用。|
|Rust|支持 [Rust](https://www.rust-lang.org) 语言，运行在内置的 WASM 运行时和 [Rust 绑定](https://lib.rs/crates/dora-ssr)上。|
+|Wa|支持 [Wa](https://wa-lang.org) 语言，一门简单可靠、静态类型的语言，运行在内置的 WASM 运行时和 [Wa 绑定](https://github.com/IppClub/Dora-SSR/tree/main/Tools/dora-wa) 上。|
|2D 骨骼动画|支持 2D 骨骼动画，包括：[Spine2D](https://github.com/EsotericSoftware/spine-runtimes)、[DragonBones](https://github.com/DragonBones/DragonBonesCPP) 以及内置系统。|
|2D 物理引擎|支持 2D 物理引擎，使用 [PlayRho](https://github.com/louis-langholtz/PlayRho)。|
|Web IDE|内置开箱即用的 Web IDE，提供文件管理，代码检查、补全、高亮和定义跳转。
|
@@ -133,9 +134,9 @@
- 2、运行软件，通过浏览器访问软件显示的服务器地址。
- 3、开始游戏开发。
-### 进行引擎的开发
+### 编译构建引擎
- 进行 Dora SSR 项目开发的安装配置，详见[官方文档](https://dora-ssr.net/zh-Hans/docs/tutorial/dev-configuration)。
+- 要自行编译构建 Dora SSR 项目，详见[官方文档](https://dora-ssr.net/zh-Hans/docs/tutorial/dev-configuration)。
diff --git a/Tools/dora-rust/dora/README.md b/Tools/dora-rust/dora/README.md
index 60602fa88..9bd1e4295 100644
--- a/Tools/dora-rust/dora/README.md
+++ b/Tools/dora-rust/dora/README.md
@@ -50,55 +50,50 @@
## Installation
-- Quick start
-
- - Android
- - 1. Download and install the [APK](https://github.com/ippclub/Dora-SSR/releases/latest) package on the running terminal for game dev.
-
- - 2. Run the software, and access the server address displayed by the software through the browser of a PC (tablet or other development device) on the LAN.
-
- - 3. Start game development.
-
- - Windows, macOS
-
- - 1. Download and run the [software](https://github.com/ippclub/Dora-SSR/releases/latest).
- - Get software on macOS with Homebrew using
- ```sh
- brew tap ippclub/dora-ssr
- brew install --cask dora-ssr
- ```
-
- - 2. Run the software and access the server address displayed by the software through a browser.
-
- - 3. Start game development.
-
-
- - Linux
-
- - 1. Installation.
-
- - Ubuntu Jammy
- ```sh
- sudo add-apt-repository ppa:ippclub/dora-ssr
- sudo apt update
- sudo apt install dora-ssr
- ```
-
- - Debian Bookworm
- ```sh
- sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 9C7705BF
- sudo add-apt-repository -S "deb https://ppa.launchpadcontent.net/ippclub/dora-ssr/ubuntu jammy main"
- sudo apt update
- sudo apt install dora-ssr
- ```
-
- - 2. Run the software and access the server address displayed by the software through a browser.
-
- - 3. Start game development.
-
-- Engine project development
-
- For the installation and configuration of Dora SSR project development, see [Official Documents](https://Dora-ssr.net/docs/tutorial/dev-configuration) for details.
+### Android
+
+- 1\. Download and install the [APK](https://github.com/ippclub/Dora-SSR/releases/latest) package on the running terminal for games.
+- 2\. Run the software, and access the server address displayed by the software through the browser of a PC (tablet or other development device) on the LAN.
+- 3\. Start game development.
+
+### Windows
+
+- 1\. Ensure that you have the X86 Visual C++ Redistributable for Visual Studio 2022 (the MSVC runtime package vc_redist.x86) installed to run the application. You can download it from the [Microsoft website](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170).
+- 2\. Download and decompress the [software](https://github.com/ippclub/Dora-SSR/releases/latest).
+- 3\. Run the software and access the server address displayed by the software through a browser.
+- 4\. Start game development.
+
+### macOS
+
+- 1\. Download and decompress the [software](https://github.com/ippclub/Dora-SSR/releases/latest). Or you can get software using [Homebrew](https://brew.sh) with:
+ ```sh
+ brew install --cask ippclub/tap/dora-ssr
+ ```
+- 2\. Run the software and access the server address displayed by the software through a browser.
+- 3\. Start game development.
+
+### Linux
+
+- 1\. Installation from PPA.
+ - Ubuntu Jammy
+ ```sh
+ sudo add-apt-repository ppa:ippclub/dora-ssr
+ sudo apt update
+ sudo apt install dora-ssr
+ ```
+ - Debian Bookworm
+ ```sh
+ sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 9C7705BF
+ sudo add-apt-repository -S "deb https://ppa.launchpadcontent.net/ippclub/dora-ssr/ubuntu jammy main"
+ sudo apt update
+ sudo apt install dora-ssr
+ ```
+- 2\. Run the software and access the server address displayed by the software through a browser.
+- 3\. Start game development.
+
+### Build Game Engine
+
+- For the building instructions of Dora SSR project, see [Official Documents](https://dora-ssr.net/docs/tutorial/dev-configuration) for details.
diff --git a/Tools/dora-wa/README.md b/Tools/dora-wa/README.md
index b0ede171b..85bcb3b0e 100644
--- a/Tools/dora-wa/README.md
+++ b/Tools/dora-wa/README.md
@@ -1,14 +1,127 @@
-# Pkg: dora
+# Dora SSR Wa Package
-欢迎使用 Wa 语言!
+A language binding project that enables Wa-lang integration with the Dora SSR game engine.
-```
-+---+ +---+
-| o | | o |
-| +----+ |
-| |
-| \/\/ |
-| |
-+------------+
-```
+## About
+This project bridges two innovative open-source projects:
+
+- **Dora SSR**: A versatile game engine designed for rapid game development across various devices. It features a built-in Web IDE that enables direct game development on mobile phones, open-source handhelds, and other devices.
+
+- **Wa-lang**: A general-purpose programming language specifically designed for WebAssembly. Wa-lang aims to provide a simple, reliable, and statically typed language for high-performance web applications.
+
+This repo provides language bindings and a testing project to demonstrate Wa-lang's capabilities when running on the Dora SSR engine.
+
+## What's in this repo
+
+- Wa-lang bindings for Dora SSR engine APIs
+- Testing and Example projects demonstrating Dora-Wa integration and usage
+
+## Installation
+
+- Install Dora SSR engine
+
+ See [Dora SSR Installation Guide](https://dora-ssr.net/docs/tutorial/quick-start)
+
+- Install Wa-lang compiler
+
+ See [Wa-lang Installation Guide](https://wa-lang.github.io/man/en/1.InstallAndGetStart/1.2.Install.html)
+
+## Usage
+
+1. Step 1: Create a new Dora SSR game project
+
+ - Make sure Dora SSR engine and Wa-lang compiler are installed.
+
+ - Launch Dora SSR software and open the Web IDE in the browser.
+
+ - In the game resource tree on the left side of the Dora Web IDE, open the right-click menu of the game resource tree.
+
+ - Click on the menu item `New` and choose to create a new folder named `Hello`.
+
+2. Step 2: Write Wa game code
+
+ - Create a new Wa project in command line.
+
+ ```sh
+ wa init -n hello_dora --wasi
+ cd hello_dora
+ ```
+
+ - Copy the whole module from `this-repo/vendor/dora` to `hello_dora/vendor/dora`.
+
+ - Write code in `src/main.wa`.
+
+ ```wa
+ import "dora"
+
+ func main() {
+ // create a sprite
+ sprite := dora.NewSpriteWithFile("Image/logo.png")
+ // create a root node of the game scene tree
+ root := dora.NewNode()
+ // mount the sprite to the root node of the game scene tree
+ root.AddChild(sprite.Node)
+ // receive and process tap event to move the sprite
+ root.OnTapBegan(func(touch: dora.Touch) {
+ sprite.PerformDef(dora.ActionDefMoveTo(
+ 1.0, // duration, unit is second
+ sprite.GetPosition(), // start position
+ touch.GetLocation(), // end position
+ dora.EaseOutBack, // easing function
+ ), false)
+ })
+ }
+ ```
+
+ - Build it into WASM file.
+
+ ```sh
+ wa build -optimize
+ ```
+
+ - Upload it to engine to run. From Dora SSR Web IDE, Open the right-click menu of the game resource tree on the created folder `Hello`. Click on the menu item `Upload` and choose the compiled WASM file named `init.wasm` to upload.
+
+ - Or use a helper script [upload.py](https://github.com/IppClub/Dora-SSR/blob/main/Tools/dora-rust/dora-test/upload.py) with commad `python3 upload.py 192.168.3.1 Hello` inside your Wa project folder to upload WASM file. The IP address is the Dora SSR Web IDE address.
+
+3. Step 3: Run the game
+
+ Click the `🎮` icon in the lower right corner of the editor, then click the menu item `Run`. Or press the key combination `Ctrl + r`.
+
+4. Step 4: Publish the game
+
+ - Open the right-click menu of the project folder just created through the game resource tree on the left side of the editor and click the `Download` option.
+
+ - Wait for the browser to pop up a download prompt for the packaged project file.
+
+## Documentation
+
+- [Dora SSR Documentation](https://github.com/ippclub/dora-ssr)
+- [Wa-lang Documentation](https://wa-lang.org)
+- [Integration Guide](link-to-your-docs)
+
+## Development Status
+
+This project is currently in development as both Wa-lang and Dora SSR are evolving. Wa-lang is in its engineering trial stage, and we're actively working on expanding the integration capabilities.
+
+## Contributing
+
+Contributions are welcome! Whether you're interested in:
+
+- Improving language bindings
+- Adding new features
+- Creating examples
+- Fixing bugs
+- Improving documentation
+
+Please feel free to submit Pull Requests or open Issues.
+
+## License
+
+MIT
+
+## Contact
+
+- For Dora SSR related questions: [Dora SSR GitHub Issues](https://github.com/ippclub/dora-ssr)
+- For Wa-lang related questions: [Wa-lang GitHub Issues](https://github.com/wa-lang/wa)
+- For binding specific issues: [Create an issue in this repository]
