You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@dubbo.apache.org by "AlexStocks (via GitHub)" <gi...@apache.org> on 2026/08/05 05:15:20 UTC
[PR] docs: update README for v3.3.2 tool releases [dubbo-go]
AlexStocks opened a new pull request, #3597:
URL: https://github.com/apache/dubbo-go/pull/3597
## What changed
- align the English and Chinese README entry points with the published Dubbo-go v3.3.2 release
- document the Go 1.25 minimum required by the v3.3.2 module
- add the missing Chinese recent-updates section and link the canonical changelog/release
- link the released cross-platform archives for `dubbogo-cli`, `protoc-gen-go-triple`, `protoc-gen-triple-openapi`, and `imports-formatter`
- document `dubbogo-cli install all` as the companion-tool installation path
The existing tool descriptions and benchmark entry remain unchanged.
Follow-up to #3585.
## Release evidence
- Dubbo-go: `v3.3.2`, final Release
- `dubbogo-cli`: `v1.0.1`
- `protoc-gen-go-triple`: `v3.3.2`
- `protoc-gen-triple-openapi`: `v3.3.2`
- `imports-formatter`: `v1.0.11`
Each tool Release currently publishes eight archives covering Darwin, Linux, and Windows architectures. The documented versions also match the version constants in `develop`.
## Validation
- `git diff --check origin/develop..HEAD`
- verified the committed file set is exactly `README.md` and `README_CN.md`
- verified both READMEs contain the same core/tool Release URLs, Go 1.25 requirement, and `dubbogo-cli install all` entry
- verified all local Markdown link targets in both READMEs exist
- queried the five GitHub Releases and confirmed they are final; each tool Release has eight assets
- compared the four documented tool versions with their source constants
Go tests were not run because this PR changes Markdown only and does not modify executable code, configuration, dependencies, generators, or tests.
## AI assistance
AI assistance: docs
Human verification: reviewed the complete diff and ran the validation commands listed above.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@dubbo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@dubbo.apache.org
For additional commands, e-mail: notifications-help@dubbo.apache.org
Re: [PR] docs: update README for v3.3.2 tool releases [dubbo-go]
Posted by "codecov-commenter (via GitHub)" <gi...@apache.org>.
codecov-commenter commented on PR #3597:
URL: https://github.com/apache/dubbo-go/pull/3597#issuecomment-5187903923
## [Codecov](https://app.codecov.io/gh/apache/dubbo-go/pull/3597?dropdown=coverage&src=pr&el=h1&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=apache) Report
:white_check_mark: All modified and coverable lines are covered by tests.
:white_check_mark: Project coverage is 53.77%. Comparing base ([`60d1c2a`](https://app.codecov.io/gh/apache/dubbo-go/commit/60d1c2a949f0ee0da4be3fe09fb79d295491e040?dropdown=coverage&el=desc&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=apache)) to head ([`bba9ca0`](https://app.codecov.io/gh/apache/dubbo-go/commit/bba9ca0db141333ca54d009f2b3a07fc8f80e3b3?dropdown=coverage&el=desc&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=apache)).
:warning: Report is 890 commits behind head on develop.
<details><summary>Additional details and impacted files</summary>
```diff
@@ Coverage Diff @@
## develop #3597 +/- ##
===========================================
+ Coverage 46.76% 53.77% +7.00%
===========================================
Files 295 474 +179
Lines 17172 36283 +19111
===========================================
+ Hits 8031 19510 +11479
- Misses 8287 15205 +6918
- Partials 854 1568 +714
```
</details>
[:umbrella: View full report in Codecov by Harness](https://app.codecov.io/gh/apache/dubbo-go/pull/3597?dropdown=coverage&src=pr&el=continue&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=apache).
:loudspeaker: Have feedback on the report? [Share it here](https://about.codecov.io/codecov-pr-comment-feedback/?utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=apache).
<details><summary> :rocket: New features to boost your workflow: </summary>
- :snowflake: [Test Analytics](https://docs.codecov.com/docs/test-analytics): Detect flaky tests, report on failures, and find test suite problems.
</details>
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@dubbo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@dubbo.apache.org
For additional commands, e-mail: notifications-help@dubbo.apache.org
Re: [PR] docs: update README for v3.3.2 tool releases [dubbo-go]
Posted by "Alanxtl (via GitHub)" <gi...@apache.org>.
Alanxtl commented on code in PR #3597:
URL: https://github.com/apache/dubbo-go/pull/3597#discussion_r3718755995
##########
README.md:
##########
@@ -125,6 +125,15 @@ Common development tools live in `tools/`.
| [dubbo-go-schema](./tools/dubbo-go-schema/README.md) | Provide JSON Schema completion and validation for dubbo-go YAML config. |
| [benchmark](./tools/benchmark/README.md) | Performance benchmark suite for comparing Dubbo-Go, Dubbo-Java, and gRPC frameworks. |
+Prebuilt archives for Darwin, Linux, and Windows are available from GitHub Releases:
+
+- [dubbogo-cli v1.0.1](https://github.com/apache/dubbo-go/releases/tag/tools/dubbogo-cli/v1.0.1)
+- [protoc-gen-go-triple v3.3.2](https://github.com/apache/dubbo-go/releases/tag/tools/protoc-gen-go-triple/v3.3.2)
+- [protoc-gen-triple-openapi v3.3.2](https://github.com/apache/dubbo-go/releases/tag/tools/protoc-gen-triple-openapi/v3.3.2)
+- [imports-formatter v1.0.11](https://github.com/apache/dubbo-go/releases/tag/tools/imports-formatter/v1.0.11)
+
+After installing `dubbogo-cli`, run `dubbogo-cli install all` to install the companion generators and formatter. Source installation commands are documented in each tool's README.
+
Review Comment:
这些不需要
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@dubbo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@dubbo.apache.org
For additional commands, e-mail: notifications-help@dubbo.apache.org
Re: [PR] docs: update README for v3.3.2 tool releases [dubbo-go]
Posted by "sonarqubecloud[bot] (via GitHub)" <gi...@apache.org>.
sonarqubecloud[bot] commented on PR #3597:
URL: https://github.com/apache/dubbo-go/pull/3597#issuecomment-6337709796
## [](https://sonarcloud.io/dashboard?id=apache_dubbo-go&pullRequest=3597) **Quality Gate passed**
Issues
 [0 New issues](https://sonarcloud.io/project/issues?id=apache_dubbo-go&pullRequest=3597&issueStatuses=OPEN,CONFIRMED&sinceLeakPeriod=true)
 [0 Accepted issues](https://sonarcloud.io/project/issues?id=apache_dubbo-go&pullRequest=3597&issueStatuses=ACCEPTED)
Measures
 [0 Security Hotspots](https://sonarcloud.io/project/security_hotspots?id=apache_dubbo-go&pullRequest=3597&issueStatuses=OPEN,CONFIRMED&sinceLeakPeriod=true)
 [0.0% Coverage on New Code](https://sonarcloud.io/component_measures?id=apache_dubbo-go&pullRequest=3597&metric=new_coverage&view=list)
 [0.0% Duplication on New Code](https://sonarcloud.io/component_measures?id=apache_dubbo-go&pullRequest=3597&metric=new_duplicated_lines_density&view=list)
<!-- sqra-placement-anchor -->
[See analysis details on SonarQube Cloud](https://sonarcloud.io/dashboard?id=apache_dubbo-go&pullRequest=3597)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@dubbo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@dubbo.apache.org
For additional commands, e-mail: notifications-help@dubbo.apache.org
Re: [PR] docs: update README for v3.3.2 tool releases [dubbo-go]
Posted by "Copilot (via GitHub)" <gi...@apache.org>.
Copilot commented on code in PR #3597:
URL: https://github.com/apache/dubbo-go/pull/3597#discussion_r3718235278
##########
README.md:
##########
@@ -17,9 +17,9 @@ You can visit [the official website](https://dubbo.apache.org/) for more informa
For detailed changes, refer to [CHANGELOG.md](CHANGELOG.md).
-- **3.3.2**:
+- **[3.3.2](https://github.com/apache/dubbo-go/releases/tag/v3.3.2)**:
- ***BREAKING CHANGE***: `config` package has been removed, please use modern `global` package, check [dubbo-go-samples](https://github.com/apache/dubbo-go-samples) for usage instructions.
+ **Upgrade note:** Go 1.25 or later is required. The legacy `config` package has been removed; applications that imported it directly must migrate to the instance/options APIs and configuration types under `global`. See the [3.3.2 changelog](CHANGELOG.md#332) and [dubbo-go-samples](https://github.com/apache/dubbo-go-samples) for migration details and current usage.
Review Comment:
The root README files appear to have their language entry points reversed: `README.md` currently contains Chinese headings/content (e.g., “## 近期更新”), while `README_CN.md` contains the English version. This makes the documented “entry points” confusing for readers and seems to contradict the PR goal of aligning English/Chinese READMEs. Consider swapping the contents (or renaming the files) and updating the language-switch links so `README.md` is English and `README_CN.md` is Chinese (or vice versa, but consistently).
##########
README_CN.md:
##########
@@ -15,11 +15,25 @@
您可以访问 [官网](https://dubbo.apache.org/) 以获取更多信息。
+## 近期更新
+
+详细变更请参阅 [CHANGELOG.md](CHANGELOG.md)。
Review Comment:
`README_CN.md` currently contains the English README text (e.g., “## Recent Updates”), while `README.md` contains the Chinese text. This reversal makes it hard to navigate between languages and undermines the stated goal of aligning the README entry points. Please swap the contents (or rename the files) and ensure the language-switch links point to the opposite-language file consistently.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@dubbo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@dubbo.apache.org
For additional commands, e-mail: notifications-help@dubbo.apache.org
Re: [PR] docs: update README for v3.3.2 tool releases [dubbo-go]
Posted by "AlexStocks (via GitHub)" <gi...@apache.org>.
AlexStocks commented on code in PR #3597:
URL: https://github.com/apache/dubbo-go/pull/3597#discussion_r3718289902
##########
README.md:
##########
@@ -17,9 +17,9 @@ You can visit [the official website](https://dubbo.apache.org/) for more informa
For detailed changes, refer to [CHANGELOG.md](CHANGELOG.md).
-- **3.3.2**:
+- **[3.3.2](https://github.com/apache/dubbo-go/releases/tag/v3.3.2)**:
- ***BREAKING CHANGE***: `config` package has been removed, please use modern `global` package, check [dubbo-go-samples](https://github.com/apache/dubbo-go-samples) for usage instructions.
+ **Upgrade note:** Go 1.25 or later is required. The legacy `config` package has been removed; applications that imported it directly must migrate to the instance/options APIs and configuration types under `global`. See the [3.3.2 changelog](CHANGELOG.md#332) and [dubbo-go-samples](https://github.com/apache/dubbo-go-samples) for migration details and current usage.
Review Comment:
已核对当前 Head `bba9ca0db141333ca54d009f2b3a07fc8f80e3b3`：`README.md` 第 10 行是 `English | [中文](README_CN.md)`，正文为英文，标题为 `## Recent Updates`。评论引用的 `## 近期更新` 实际位于 `README_CN.md`。本地 blob 与 GitHub raw blob 一致，因此无需交换或重命名文件。
##########
README_CN.md:
##########
@@ -15,11 +15,25 @@
您可以访问 [官网](https://dubbo.apache.org/) 以获取更多信息。
+## 近期更新
+
+详细变更请参阅 [CHANGELOG.md](CHANGELOG.md)。
Review Comment:
已核对当前 Head `bba9ca0db141333ca54d009f2b3a07fc8f80e3b3`：`README_CN.md` 第 10 行是 `[English](README.md) | 中文`，正文为中文，标题为 `## 近期更新`。评论引用的 `## Recent Updates` 实际位于 `README.md`。语言入口和跳转链接已经一致，因此无需修改。
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@dubbo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@dubbo.apache.org
For additional commands, e-mail: notifications-help@dubbo.apache.org
Re: [PR] docs: update README for v3.3.2 tool releases [dubbo-go]
Posted by "Alanxtl (via GitHub)" <gi...@apache.org>.
Alanxtl merged PR #3597:
URL: https://github.com/apache/dubbo-go/pull/3597
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@dubbo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@dubbo.apache.org
For additional commands, e-mail: notifications-help@dubbo.apache.org
Re: [PR] docs: update README for v3.3.2 tool releases [dubbo-go]
Posted by "sonarqubecloud[bot] (via GitHub)" <gi...@apache.org>.
sonarqubecloud[bot] commented on PR #3597:
URL: https://github.com/apache/dubbo-go/pull/3597#issuecomment-5187843292
## [](https://sonarcloud.io/dashboard?id=apache_dubbo-go&pullRequest=3597) **Quality Gate passed**
Issues
 [0 New issues](https://sonarcloud.io/project/issues?id=apache_dubbo-go&pullRequest=3597&issueStatuses=OPEN,CONFIRMED&sinceLeakPeriod=true)
 [0 Accepted issues](https://sonarcloud.io/project/issues?id=apache_dubbo-go&pullRequest=3597&issueStatuses=ACCEPTED)
Measures
 [0 Security Hotspots](https://sonarcloud.io/project/security_hotspots?id=apache_dubbo-go&pullRequest=3597&issueStatuses=OPEN,CONFIRMED&sinceLeakPeriod=true)
 [0.0% Coverage on New Code](https://sonarcloud.io/component_measures?id=apache_dubbo-go&pullRequest=3597&metric=new_coverage&view=list)
 [0.0% Duplication on New Code](https://sonarcloud.io/component_measures?id=apache_dubbo-go&pullRequest=3597&metric=new_duplicated_lines_density&view=list)
<!-- sqra-placement-anchor -->
[See analysis details on SonarQube Cloud](https://sonarcloud.io/dashboard?id=apache_dubbo-go&pullRequest=3597)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@dubbo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@dubbo.apache.org
For additional commands, e-mail: notifications-help@dubbo.apache.org
Re: [PR] docs: update README for v3.3.2 tool releases [dubbo-go]
Posted by "AlexStocks (via GitHub)" <gi...@apache.org>.
AlexStocks commented on code in PR #3597:
URL: https://github.com/apache/dubbo-go/pull/3597#discussion_r4346809400
##########
README.md:
##########
@@ -125,6 +125,15 @@ Common development tools live in `tools/`.
| [dubbo-go-schema](./tools/dubbo-go-schema/README.md) | Provide JSON Schema completion and validation for dubbo-go YAML config. |
| [benchmark](./tools/benchmark/README.md) | Performance benchmark suite for comparing Dubbo-Go, Dubbo-Java, and gRPC frameworks. |
+Prebuilt archives for Darwin, Linux, and Windows are available from GitHub Releases:
+
+- [dubbogo-cli v1.0.1](https://github.com/apache/dubbo-go/releases/tag/tools/dubbogo-cli/v1.0.1)
+- [protoc-gen-go-triple v3.3.2](https://github.com/apache/dubbo-go/releases/tag/tools/protoc-gen-go-triple/v3.3.2)
+- [protoc-gen-triple-openapi v3.3.2](https://github.com/apache/dubbo-go/releases/tag/tools/protoc-gen-triple-openapi/v3.3.2)
+- [imports-formatter v1.0.11](https://github.com/apache/dubbo-go/releases/tag/tools/imports-formatter/v1.0.11)
+
+After installing `dubbogo-cli`, run `dubbogo-cli install all` to install the companion generators and formatter. Source installation commands are documented in each tool's README.
+
Review Comment:
已按意见移除，提交 `c7a3871b`。
- `README.md` 与 `README_CN.md` 的「Prebuilt archives / 预编译压缩包」整段（4 个 Release 链接 + `dubbogo-cli install all` 说明）已删除，两文件各 -9 行。
- `tools/` 表格保留，字段与各工具 README 链接未改动。
- 本 PR 当前净变更 +18/-4，只剩 3.3.2 更新说明（含 Release 链接与升级提醒）与 Go 1.25 前置要求；`go.mod` 为 `go 1.25.0`、`CHANGELOG.md` 首行为 `## 3.3.2`，与文档中的表述和 `CHANGELOG.md#332` 锚点一致。
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: notifications-unsubscribe@dubbo.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@dubbo.apache.org
For additional commands, e-mail: notifications-help@dubbo.apache.org