This is an automated email from the ASF dual-hosted git repository.
xuetaoli pushed a commit to branch develop
in repository https://gitbox.apache.org/repos/asf/dubbo-go.git
The following commit(s) were added to refs/heads/develop by this push:
new ddb0f1b01 doc: add dubbo-go-extensions in readme (#3260)
ddb0f1b01 is described below
commit ddb0f1b01297cc2dc0cd24f134cd6af56bce6608
Author: Zecheng Zhu <[email protected]>
AuthorDate: Sat Mar 21 16:37:20 2026 +0800
doc: add dubbo-go-extensions in readme (#3260)
* doc: add dubbo-go-extensions in readme
* doc: refine README ecosystem and tools sections
---
README.md | 33 ++++++---------------------------
README_CN.md | 30 +++++-------------------------
2 files changed, 11 insertions(+), 52 deletions(-)
diff --git a/README.md b/README.md
index c29efca73..b16fb5ba4 100644
--- a/README.md
+++ b/README.md
@@ -106,32 +106,20 @@ Dubbo-go provides robust service governance capabilities:
- **HA Strategy**: Failover, Failfast, Failsafe/Failback, Available,
Broadcast, Forking.
- **Interoperability**: Full compatibility with Apache Dubbo (Java) via Triple
protocol generic calls, group/version wildcard matching, and TLS API redesign.
-
## ️ Tools
The `tools/` directory and the `dubbogo/tools` repository provide several
utilities to streamline your Dubbo-Go development experience.
###
[dubbo-go-schema](https://github.com/apache/dubbo-go/tree/main/tools/dubbo-go-schema)
-A tool that provides JSON Schema for Dubbo-Go configuration files. This
simplifies the configuration process by enabling editor assistance.
-
-**Features:**
-
-* **Intelligent Assistance:** Enables code completion, hints, and real-time
validation for configuration files in supported IDEs.
-* **Simplified Configuration:** Helps you write valid and accurate
configurations with ease.
+A tool that provides JSON Schema for Dubbo-Go configuration files, enabling
editor assistance such as completion, hints, and validation.
For usage details, see the [dubbo-go-schema
README](./tools/dubbo-go-schema/README.md).
###
[dubbogo-cli](https://github.com/apache/dubbo-go/tree/main/tools/dubbogo-cli)
-A comprehensive command-line tool for bootstrapping, managing, and debugging
your Dubbo-Go applications.
-
-**Features:**
-
-* **Project Scaffolding:** Quickly create new application templates.
-* **Tool Management:** Install and manage essential development tools.
-* **Interface Debugging:** Provides commands to debug your services.
+A command-line tool for bootstrapping, managing, and debugging Dubbo-Go
applications.
- [dubbogo-cli](https://github.com/apache/dubbo-go/tree/main/tools/dubbogo-cli)
-
[dubbogo-cli-v2](https://github.com/dubbogo/tools/tree/master/cmd/dubbogo-cli-v2)
@@ -139,12 +127,7 @@ A comprehensive command-line tool for bootstrapping,
managing, and debugging you
### [protoc-gen-go-triple](https://github.com/dubbogo/protoc-gen-go-triple)
-A `protoc` plugin that generates golang code for the Triple protocol from your
`.proto` (Protocol Buffer) definition files.
-
-**Features:**
-
-* **Code Generation:** Generates golang client and server stubs for the Triple
protocol.
-* **Seamless Integration:** Works alongside the official `protoc-gen-go` to
produce both Protobuf message code (`.pb.go`) and Triple interface code
(`.triple.go`).
+A `protoc` plugin that generates Go client and server code for the Triple
protocol from `.proto` definition files.
*Note: This tool replaces the deprecated
[protoc-gen-dubbo3grpc](https://github.com/dubbogo/tools/tree/master/cmd/protoc-gen-dubbo3grpc)
and deprecated
[protoc-gen-go-triple](https://github.com/dubbogo/tools/tree/master/cmd/protoc-gen-go-triple).*
@@ -153,12 +136,7 @@ For usage details, see the [protoc-gen-go-triple
README](https://github.com/dubb
###
[imports-formatter](https://github.com/dubbogo/tools?tab=readme-ov-file#imports-formatter)
-This is a plugin for dubbo-go developers. A code formatting tool that
organizes golang `import` blocks according to the Dubbo-Go community style
guide.
-
-**Features:**
-
-* **Automatic Formatting:** Splits `import` statements into three distinct
groups: golang standard library, third-party libraries, and internal project
packages.
-* **Code Consistency:** Enforces a clean and consistent import style across
the codebase.
+A formatting tool for Dubbo-Go developers that organizes Go `import` blocks
according to the community style guide.
For usage details, see the [imports-formatter
README](https://github.com/dubbogo/tools?tab=readme-ov-file#imports-formatter).
@@ -168,6 +146,7 @@ For usage details, see the [imports-formatter
README](https://github.com/dubbogo
- [Interoperability with Dubbo
Java](https://cn.dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/interop-dubbo/)
- [Protoc-gen-go-triple](https://github.com/dubbogo/protoc-gen-go-triple/)
- [Console](https://github.com/apache/dubbo-kubernetes), under development
+- [dubbo-go-extensions](https://github.com/apache/dubbo-go-extensions), under
development
## Documentation
@@ -318,4 +297,4 @@ If you are using
[apache/dubbo-go](https://github.com/apache/dubbo-go) and think
## License
-Apache Dubbo-go software is licensed under the Apache License Version 2.0. See
the [LICENSE](./LICENSE) file for details.
\ No newline at end of file
+Apache Dubbo-go software is licensed under the Apache License Version 2.0. See
the [LICENSE](./LICENSE) file for details.
diff --git a/README_CN.md b/README_CN.md
index 657de8b3c..5a3b61fae 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -104,24 +104,13 @@ func main() {
###
[dubbo-go-schema](https://github.com/apache/dubbo-go/tree/main/tools/dubbo-go-schema)
-该工具为 Dubbo-Go 配置文件提供 JSON Schema,通过编辑器辅助功能简化配置过程。
-
-**功能:**
-
-* **智能辅助:** 在支持的 IDE 中为配置文件启用代码补全、提示和实时校验。
-* **简化配置:** 帮助您轻松编写有效且准确的配置。
+该工具为 Dubbo-Go 配置文件提供 JSON Schema,支持编辑器中的代码补全、提示和实时校验。
有关使用详情,请参阅 [dubbo-go-schema README](./tools/dubbo-go-schema/README.md)。
###
[dubbogo-cli](https://github.com/apache/dubbo-go/tree/main/tools/dubbogo-cli)
-一个功能全面的命令行工具,用于引导、管理和调试您的 Dubbo-Go 应用。
-
-**功能:**
-
-* **项目脚手架:** 快速创建新的应用模板。
-* **工具管理:** 安装和管理必要的开发工具。
-* **接口调试:** 提供命令来调试您的服务。
+一个用于引导、管理和调试 Dubbo-Go 应用的命令行工具。
- [dubbogo-cli](https://github.com/apache/dubbo-go/tree/main/tools/dubbogo-cli)
-
[dubbogo-cli-v2](https://github.com/dubbogo/tools/tree/master/cmd/dubbogo-cli-v2)
@@ -129,12 +118,7 @@ func main() {
### [protoc-gen-go-triple](https://github.com/dubbogo/protoc-gen-go-triple)
-一个 `protoc` 插件,用于从您的 `.proto` (Protocol Buffer) 定义文件为 Triple 协议生成 Golang 代码。
-
-**功能:**
-
-* **代码生成:** 为 Triple 协议生成 Golang 客户端和服务器存根(stub)。
-* **无缝集成:** 与官方的 `protoc-gen-go` 协同工作,同时生成 Protobuf 消息代码(`.pb.go`)和 Triple
接口代码(`.triple.go`)。
+一个 `protoc` 插件,用于从 `.proto` 定义文件生成 Triple 协议的 Golang 客户端和服务端代码。
*注意:该工具取代了已废弃的
[protoc-gen-dubbo3grpc](https://github.com/dubbogo/tools/tree/master/cmd/protoc-gen-dubbo3grpc)
和已废弃的
[protoc-gen-go-triple](https://github.com/dubbogo/tools/tree/master/cmd/protoc-gen-go-triple)。*
@@ -142,12 +126,7 @@ func main() {
###
[imports-formatter](https://github.com/dubbogo/tools?tab=readme-ov-file#imports-formatter)
-这是一个面向 Dubbo-Go 开发者的插件,它是一款代码格式化工具,它根据 Dubbo-Go 社区的风格指南来组织 Golang 的 `import`
代码块。
-
-**功能:**
-
-* **自动格式化:** 将 `import` 语句分为三个独立的组:Golang 标准库、第三方库和项目内部包。
-* **代码一致性:** 在整个代码库中强制执行干净、一致的导入风格。
+这是一个面向 Dubbo-Go 开发者的格式化工具,用于按照社区风格指南整理 Golang 的 `import` 代码块。
有关使用详情,请参阅 [imports-formatter
README](https://github.com/dubbogo/tools?tab=readme-ov-file#imports-formatter)。
@@ -158,6 +137,7 @@ func main() {
- [与 Dubbo Java
互通](https://cn.dubbo.apache.org/zh-cn/overview/mannual/golang-sdk/tutorial/interop-dubbo/)
- [Protoc-gen-go-triple](https://github.com/dubbogo/protoc-gen-go-triple/)
- [控制台 (Console)](https://github.com/apache/dubbo-kubernetes),开发中
+- [dubbo-go-extensions](https://github.com/apache/dubbo-go-extensions),建设中
## 社区与文档