This is an automated email from the ASF dual-hosted git repository.
alexstocks pushed a commit to branch 3.0
in repository https://gitbox.apache.org/repos/asf/dubbo-go.git
The following commit(s) were added to refs/heads/3.0 by this push:
new ca2a46f update README (#1269)
ca2a46f is described below
commit ca2a46f8dfb22e1c02fbfe2a3695356429525d09
Author: XavierNiu <[email protected]>
AuthorDate: Sun Jun 20 22:49:18 2021 +0800
update README (#1269)
update Reporting bugs
use chinese
rename contributing
rename CONTRIBUTING
update README_CN
fix typo
fix CONTRIBUTING file path
update quick start link
fix typo
fix type
fix typo
---
.gitignore | 3 +
CHANGE.md => CHANGELOG.md | 0
contributing.md => CONTRIBUTING.md | 0
README.md | 236 +++++++------------------------------
README_CN.md | 235 +++++++-----------------------------
5 files changed, 85 insertions(+), 389 deletions(-)
diff --git a/.gitignore b/.gitignore
index 898962e..f161759 100644
--- a/.gitignore
+++ b/.gitignore
@@ -38,3 +38,6 @@ config_center/apollo/mockDubbog.properties.json
.*.sw?
/license-header-checker-linux/
/license-header-checker-linux.zip
+
+# macOS
+.DS_Store
diff --git a/CHANGE.md b/CHANGELOG.md
similarity index 100%
rename from CHANGE.md
rename to CHANGELOG.md
diff --git a/contributing.md b/CONTRIBUTING.md
similarity index 100%
rename from contributing.md
rename to CONTRIBUTING.md
diff --git a/README.md b/README.md
index 264da73..c3031e8 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# Apache Dubbo-go [中文](./README_CN.md) #
+# Apache Dubbo-go
[](https://travis-ci.org/apache/dubbo-go)
[](https://codecov.io/gh/apache/dubbo-go)
@@ -8,223 +8,66 @@
---
-Apache Dubbo Go Implementation to bridge the gap between java and go.
+[中文 🇨🇳](./README_CN.md)
+Apache Dubbo-go, a Dubbo implementation written in Golang, is born to bridge
the gap between Java and Golang. Please visit our [official
website](https://dubbogo.github.io) for the quick start and documentation.
-## License
-
-Apache License, Version 2.0
-
-## Release note ##
-
-[v1.5.6 - Apr 8, 2021](https://github.com/apache/dubbo-go/releases/tag/v1.5.6)
-
-[v1.5.5 - Jan 5, 2021](https://github.com/apache/dubbo-go/releases/tag/v1.5.5)
-
-[v1.4.5 - Nov 18, 2020](https://github.com/apache/dubbo-go/releases/tag/v1.4.5)
-
-[v1.5.4 - Nov 1, 2020](https://github.com/apache/dubbo-go/releases/tag/v1.5.4)
-
-[v1.5.3 - Sep 23, 2020](https://github.com/apache/dubbo-go/releases/tag/v1.5.3)
-
-[v1.5.1 - Aug 23, 2020](https://github.com/apache/dubbo-go/releases/tag/v1.5.1)
-
-[v1.5.0 - July 24,
2020](https://github.com/apache/dubbo-go/releases/tag/v1.5.0)
-
-[v1.4.0 - Mar 17, 2020](https://github.com/apache/dubbo-go/releases/tag/v1.4.0)
-
-[v1.3.0 - Mar 1, 2020](https://github.com/apache/dubbo-go/releases/tag/v1.3.0)
-
-[v1.2.0 - Nov 15, 2019](https://github.com/apache/dubbo-go/releases/tag/v1.2.0)
-
-[v1.1.0 - Sep 7, 2019 the first release after transferred to
apache](https://github.com/apache/dubbo-go/releases/tag/v1.1.0)
-
-[v1.0.0 - May 29, 2019 compatible with dubbo
v2.6.5](https://github.com/apache/dubbo-go/releases/tag/v1.0.0)
-
-## Project Architecture ##
-
-Both extension module and layered project architecture is according to Apache
Dubbo (including protocol layer, registry layer, cluster layer, config layer
and so on), the advantage of this arch is as following: you can implement these
layered interfaces in your own way, override the default implementation of
dubbo-go by calling 'extension.SetXXX' of extension, complete your special
needs without modifying the source code. At the same time, you are welcome to
contribute implementation of [...]
-
-
-
-If you want to know more about dubbo-go, please visit this reference [Project
Architecture
design](https://github.com/apache/dubbo-go/wiki/dubbo-go-V1.0-design)
+## Architecture
-## Feature list ##
+
-Finished List:
+Dubbo-go has been implemented most layers of Dubbo, like protocol layer,
registry layer, etc. An extension module is applied to Dubbo-go in order to
achieve a more flexible architecture. Developers are allowed to implement a
customized layer conformed to the layer interface and use then in Dubbo-go via
`extension.Set` method without modifying the source code.
-- Role
- * Consumer
- * Provider
+## Features
-- Transport
- * HTTP
- * TCP
+The features that are available for Dubbo-go are:
-- Codec
- * JsonRPC V2
- * Hessian V2
- * [json for grpc](https://github.com/apache/dubbo-go/pull/582)
- * protobuf
+- **Role**: Consumer, Provider
+- **Transport**: HTTP, TCP
+- **Codec**: JsonRPC V2, Hessian V2, [Json for
gRPC](https://github.com/apache/dubbo-go/pull/582), Protocol Buffers
+- **Protocol**: Dubbo, [Triple](https://github.com/dubbogo/triple), JsonRPC
V2, [gRPC](https://github.com/apache/dubbo-go/pull/311),
[RESTful](https://github.com/apache/dubbo-go/pull/352)
+- **Router**: [Dubbo3 Router](https://github.com/apache/dubbo-go/pull/1187)
+- **Registry**: ZooKeeper,
[etcd](https://github.com/apache/dubbo-go/pull/148),
[Nacos](https://github.com/apache/dubbo-go/pull/151),
[Consul](https://github.com/apache/dubbo-go/pull/121),
[K8s](https://github.com/apache/dubbo-go/pull/400)
+- **Dynamic Configure Center & Service Management Configurator**: Zookeeper,
[Apollo](https://github.com/apache/dubbo-go/pull/250),
[Nacos](https://github.com/apache/dubbo-go/pull/357)
+- **Cluster Strategy**: Failover,
[Failfast](https://github.com/apache/dubbo-go/pull/140),
[Failsafe/Failback](https://github.com/apache/dubbo-go/pull/136),
[Available](https://github.com/apache/dubbo-go/pull/155),
[Broadcast](https://github.com/apache/dubbo-go/pull/158),
[Forking](https://github.com/apache/dubbo-go/pull/161)
+- **Load Balance**: Random,
[RoundRobin](https://github.com/apache/dubbo-go/pull/66),
[LeastActive](https://github.com/apache/dubbo-go/pull/65),
[ConsistentHash](https://github.com/apache/dubbo-go/pull/261)
+- **Filter**: Echo Health Check, [Circuit Break and Service
Downgrade](https://github.com/apache/dubbo-go/pull/133),
[TokenFilter](https://github.com/apache/dubbo-go/pull/202),
[AccessLogFilter](https://github.com/apache/dubbo-go/pull/214),
[TpsLimitFilter](https://github.com/apache/dubbo-go/pull/237),
[ExecuteLimitFilter](https://github.com/apache/dubbo-go/pull/246),
[GenericServiceFilter](https://github.com/apache/dubbo-go/pull/291),
[Auth/Sign](https://github.com/apache/dubbo-go/pull/ [...]
+- **Invoke**: [Generic Invoke](https://github.com/apache/dubbo-go/pull/122)
+- **Monitor**: Opentracing API,
[Prometheus](https://github.com/apache/dubbo-go/pull/342)
+- **Tracing**: [For JsonRPC](https://github.com/apache/dubbo-go/pull/335),
[For Dubbo](https://github.com/apache/dubbo-go/pull/344), [For
gRPC](https://github.com/apache/dubbo-go/pull/397)
+- **Metadata Center**:
[Nacos(Local)](https://github.com/apache/dubbo-go/pull/522),
[ZooKeeper(Local)](https://github.com/apache/dubbo-go/pull/633),
[etcd(Local)](https://github.com/apache/dubbo-go/blob/9a5990d9a9c3d5e6633c0d7d926c156416bcb931/metadata/report/etcd/report.go),
[Consul(Local)](https://github.com/apache/dubbo-go/pull/633),
[ZooKeeper(Remoting)](https://github.com/apache/dubbo-go/pull/1161)
+- **Tool**: [Dubbo-go-cli](https://github.com/apache/dubbo-go/pull/818)
-- Protocol
- * Dubbo
- * [Triple](https://github.com/dubbogo/triple)
- * Jsonrpc2.0
- * [gRPC](https://github.com/apache/dubbo-go/pull/311)
- * [RESTful](https://github.com/apache/dubbo-go/pull/352)
+## Getting started
-- Router
- * [Dubbo3 router](https://github.com/apache/dubbo-go/pull/1187)
+### Install Dubbo-go v3
-- Registry
- * ZooKeeper
- * [etcd v3](https://github.com/apache/dubbo-go/pull/148)
- * [nacos](https://github.com/apache/dubbo-go/pull/151)
- * [consul](https://github.com/apache/dubbo-go/pull/121)
- * [k8s](https://github.com/apache/dubbo-go/pull/400)
-
-- Dynamic Configure Center & Service Management Configurator
- * Zookeeper
- * [apollo](https://github.com/apache/dubbo-go/pull/250)
- * [nacos](https://github.com/apache/dubbo-go/pull/357)
-
-- Cluster Strategy
- * Failover
- * [Failfast](https://github.com/apache/dubbo-go/pull/140)
- * [Failsafe/Failback](https://github.com/apache/dubbo-go/pull/136)
- * [Available](https://github.com/apache/dubbo-go/pull/155)
- * [Broadcast](https://github.com/apache/dubbo-go/pull/158)
- * [Forking](https://github.com/apache/dubbo-go/pull/161)
-
-- Load Balance
- * Random
- * [RoundRobin](https://github.com/apache/dubbo-go/pull/66)
- * [LeastActive](https://github.com/apache/dubbo-go/pull/65)
- * [ConsistentHash](https://github.com/apache/dubbo-go/pull/261)
-
-- Filter
- * Echo Health Check
- * [Circuit break and service
downgrade](https://github.com/apache/dubbo-go/pull/133)
- * [TokenFilter](https://github.com/apache/dubbo-go/pull/202)
- * [AccessLogFilter](https://github.com/apache/dubbo-go/pull/214)
- * [TpsLimitFilter](https://github.com/apache/dubbo-go/pull/237)
- * [ExecuteLimitFilter](https://github.com/apache/dubbo-go/pull/246)
- * [GenericServiceFilter](https://github.com/apache/dubbo-go/pull/291)
- * [Auth/Sign](https://github.com/apache/dubbo-go/pull/323)
- * [Metrics filter](https://github.com/apache/dubbo-go/pull/342)
- * [Tracing filter](https://github.com/apache/dubbo-go/pull/335)
-
-- Invoke
- * [generic invoke](https://github.com/apache/dubbo-go/pull/122)
-
-- Monitor
- * Opentracing API
- * [Prometheus](https://github.com/apache/dubbo-go/pull/342)
-
-- Tracing
- * [For jsonrpc](https://github.com/apache/dubbo-go/pull/335)
- * [For dubbo](https://github.com/apache/dubbo-go/pull/344)
- * [For grpc](https://github.com/apache/dubbo-go/pull/397)
-
-- Metadata Center
- * [Nacos(Local)](https://github.com/apache/dubbo-go/pull/522)
- * [Zookeeper(Local)](https://github.com/apache/dubbo-go/pull/633)
- *
[Etcd(Local)](https://github.com/apache/dubbo-go/blob/9a5990d9a9c3d5e6633c0d7d926c156416bcb931/metadata/report/etcd/report.go)
- * [Consul(Local)](https://github.com/apache/dubbo-go/pull/633)
- * [Zookeeper(Remoting)](https://github.com/apache/dubbo-go/pull/1161)
-
-- Tool
- * [Dubbo-go-cli](https://github.com/apache/dubbo-go/pull/818)
-
-You can know more about dubbo-go by its
[roadmap](https://github.com/apache/dubbo-go/wiki/Roadmap).
-
-
-
-## Document
-
-[dubbo-doc](http://dubbo.apache.org/zh/blog/) or
[dubbo-go-doc-list](http://alexstocks.github.io/html/dubbogo.html)
-
-## Quick Start
-
-[dubbo-go-samples](https://github.com/apache/dubbo-go-samples) gives many
examples to tell u how to use dubbo-go. Please read the
[dubbo-samples/golang/README.md](https://github.com/apache/dubbo-go-samples/blob/master/README.md)
carefully to learn how to dispose the configuration and compile the program.
-
-## Running unit tests
-
-### Run
-
-```bash
-make verify
```
-
-### Verify license
-
-```bash
-make license
+go get dubbo.apache.org/dubbo-go/v3
```
-### Run unit test
-
-```bash
-make test
-```
+### Next steps
-## Build
-
-Please move to [dubbo-samples/golang](https://github.com/dubbogo/dubbo-samples)
+- [Dubbo-go Samples](https://github.com/apache/dubbo-go-samples): The project
gives a series of samples that show each feature available for Dubbo-go and
help you know how to integrate Dubbo-go with your system.
+- Dubbo-go Quick Start: [中文
🇨🇳](https://dubbogo.github.io/zh-cn/docs/user/quickstart/3.0/quickstart.html),
[English 🇺🇸](https://dubbogo.github.io/en-us/docs/user/quick-start.html)
+- [Dubbo-go Benchmark](https://github.com/dubbogo/dubbo-go-benchmark)
+- [Dubbo-go Wiki](https://github.com/apache/dubbo-go/wiki)
## Contributing
-If you are willing to do some code contributions and document contributions to
[Apache/dubbo-go](https://github.com/apache/dubbo-go), please visit
[contribution
intro](https://github.com/apache/dubbo-go/blob/master/contributing.md).
+Please visit [CONTRIBUTING](./CONTRIBUTING.md) for details on submitting
patches and the contribution workflow.
-## Community
+## Reporting bugs
-If u want to communicate with our community, pls scan the following dubbobo
DingDing QR code or search our commnity DingDing group code 31363295.
+Please use the [bug report template](issues/new?template=bug-report.md) to
report bugs, use the [enhancement template](issues/new?template=enhancement.md)
to provide suggestions for improvement.
-<div>
-<table>
- <tbody>
- <tr></tr>
- <tr>
- <td align="center" valign="middle">
- <a href="http://alexstocks.github.io/html/dubbogo.html";
target="_blank">
- <img width="80px" height="85px"
src="./doc/pic/misc/dubbogo-dingding.png">
- </a>
- </td>
- </tr>
- <tr></tr>
- </tbody>
-</table>
-</div>
+## Contact
-If u want to visit the wechat group, pls add my wechat AlexanderStocks or scan
the following wechat picture.
-
-<div>
-<table>
- <tbody>
- <tr></tr>
- <tr>
- <td align="center" valign="middle">
- <img width="80px" height="115px"
src="./doc/pic/misc/dubbogo-wechat.png">
- </a>
- </td>
- </tr>
- <tr></tr>
- </tbody>
-</table>
-</div>
-
-We welcome the friends who can give us constructing suggestions instead of
known-nothing.
-
-## Benchmark
-
-Benchmark project
[dubbo-go-benchmark](https://github.com/dubbogo/dubbo-go-benchmark).
-
-About dubbo-go benchmarking report, please refer to [dubbo benchmarking
report](https://github.com/apache/dubbo-go/wiki/Benchmark-test-of-dubbo) &
[jsonrpc benchmarking
report](https://github.com/apache/dubbo-go/wiki/Benchmark-test-of-jsonrpc).
+- [DingTalk Group](https://www.dingtalk.com/en): 23331795
## [User List](https://github.com/apache/dubbo-go/issues/2)
-If you are using [apache/dubbo-go](https://github.com/apache/dubbo-go) and
think that it helps you or want do some contributions to it, please add your
company to to [the user list](https://github.com/apache/dubbo-go/issues/2) to
let us know your needs.
+If you are using [apache/dubbo-go](https://github.com/apache/dubbo-go) and
think that it helps you or want to contribute code for Dubbo-go, please add
your company to [the user list](https://github.com/apache/dubbo-go/issues/2) to
let us know your needs.
<div>
@@ -314,5 +157,8 @@ If you are using
[apache/dubbo-go](https://github.com/apache/dubbo-go) and think
</table>
</div>
-[MORE USER CASE](https://github.com/apache/dubbo-go/issues/2)
+[See more user cases](https://github.com/apache/dubbo-go/issues/2)
+
+## License
+Apache Dubbo-go software is licenced under the Apache License Version 2.0. See
the LICENSE file for details.
diff --git a/README_CN.md b/README_CN.md
index 559e339..2f7963f 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -1,4 +1,4 @@
-# Apache Dubbo-go [English](./README.md) #
+# Apache Dubbo-go
[](https://travis-ci.org/apache/dubbo-go)
[](https://codecov.io/gh/apache/dubbo-go)
@@ -8,220 +8,64 @@
---
-Apache Dubbo Go 语言实现，架起java和go之间的桥梁，与 gRPC/Spring Cloud
生态互联互通，带领Java生态享受云原生时代的技术红利。
+[English 🇺🇸](./README.md)
-## 证书 ##
+Apache Dubbo Go 语言实现，架起 Java 和 Golang 之间的桥梁，与 gRPC/Spring Cloud 生态互联互通，带领 Java
生态享受云原生时代的技术红利。请访问我们的[官方网站](https://dubbogo.github.io)查看快速开始和文档。
-Apache License, Version 2.0
+## 架构
-## 发布日志 ##
+
-[v1.5.6 - 2021年4月8日](https://github.com/apache/dubbo-go/releases/tag/v1.5.6)
+Dubbo-go已经实现了Dubbo的大部分层级，包括协议层（protocol layer）、注册层（registry
layer)）等等。在Dubbo-go中使用了拓展模块（extension
module）以实现更灵活的系统架构，开发者可以根据层接口实现一个自定义的层，并在不改动源代码的前提下通过`extension.Set`方法将它应用到Dubbo-go中。
-[v1.5.5 - 2021年1月5日](https://github.com/apache/dubbo-go/releases/tag/v1.5.5)
+## 特性
-[v1.4.5 - 2020年11月18日](https://github.com/apache/dubbo-go/releases/tag/v1.4.5)
+Dubbo-go中已实现的特性：
-[v1.5.4 - 2020年11月1日](https://github.com/apache/dubbo-go/releases/tag/v1.5.4)
+- **角色**: Consumer, Provider
+- **传输协议**: HTTP, TCP
+- **序列化协议**: JsonRPC V2, Hessian V2, [Json for
gRPC](https://github.com/apache/dubbo-go/pull/582), Protocol Buffers
+- **协议**: Dubbo, [Triple](https://github.com/dubbogo/triple), JsonRPC V2,
[gRPC](https://github.com/apache/dubbo-go/pull/311),
[RESTful](https://github.com/apache/dubbo-go/pull/352)
+- **路由器**: [Dubbo3 Router](https://github.com/apache/dubbo-go/pull/1187)
+- **注册中心**: ZooKeeper, [etcd](https://github.com/apache/dubbo-go/pull/148),
[Nacos](https://github.com/apache/dubbo-go/pull/151),
[Consul](https://github.com/apache/dubbo-go/pull/121),
[K8s](https://github.com/apache/dubbo-go/pull/400)
+- **动态配置中心与服务治理配置器**: Zookeeper,
[Apollo](https://github.com/apache/dubbo-go/pull/250),
[Nacos](https://github.com/apache/dubbo-go/pull/357)
+- **集群策略**: Failover, [Failfast](https://github.com/apache/dubbo-go/pull/140),
[Failsafe/Failback](https://github.com/apache/dubbo-go/pull/136),
[Available](https://github.com/apache/dubbo-go/pull/155),
[Broadcast](https://github.com/apache/dubbo-go/pull/158),
[Forking](https://github.com/apache/dubbo-go/pull/161)
+- **负载均衡策略**: Random,
[RoundRobin](https://github.com/apache/dubbo-go/pull/66),
[LeastActive](https://github.com/apache/dubbo-go/pull/65),
[ConsistentHash](https://github.com/apache/dubbo-go/pull/261)
+- **过滤器**: Echo Health Check, [Circuit Break and Service
Downgrade](https://github.com/apache/dubbo-go/pull/133),
[TokenFilter](https://github.com/apache/dubbo-go/pull/202),
[AccessLogFilter](https://github.com/apache/dubbo-go/pull/214),
[TpsLimitFilter](https://github.com/apache/dubbo-go/pull/237),
[ExecuteLimitFilter](https://github.com/apache/dubbo-go/pull/246),
[GenericServiceFilter](https://github.com/apache/dubbo-go/pull/291),
[Auth/Sign](https://github.com/apache/dubbo-go/pull/323 [...]
+- **调用**: [Generic Invoke](https://github.com/apache/dubbo-go/pull/122)
+- **监控**: Opentracing API,
[Prometheus](https://github.com/apache/dubbo-go/pull/342)
+- **Tracing**: [For JsonRPC](https://github.com/apache/dubbo-go/pull/335),
[For Dubbo](https://github.com/apache/dubbo-go/pull/344), [For
gRPC](https://github.com/apache/dubbo-go/pull/397)
+- **元数据中心**: [Nacos(Local)](https://github.com/apache/dubbo-go/pull/522),
[ZooKeeper(Local)](https://github.com/apache/dubbo-go/pull/633),
[etcd(Local)](https://github.com/apache/dubbo-go/blob/9a5990d9a9c3d5e6633c0d7d926c156416bcb931/metadata/report/etcd/report.go),
[Consul(Local)](https://github.com/apache/dubbo-go/pull/633),
[ZooKeeper(Remoting)](https://github.com/apache/dubbo-go/pull/1161)
+- **工具**: [Dubbo-go-cli](https://github.com/apache/dubbo-go/pull/818)
-[v1.5.3 - 2020年9月23日](https://github.com/apache/dubbo-go/releases/tag/v1.5.3)
+## 开始
-[v1.5.1 - 2020年8月23日](https://github.com/apache/dubbo-go/releases/tag/v1.5.1)
+### 安装 Dubbo-go v3
-[v1.5.0 - 2020年7月24日](https://github.com/apache/dubbo-go/releases/tag/v1.5.0)
-
-[v1.4.0 - 2020年3月17日](https://github.com/apache/dubbo-go/releases/tag/v1.4.0)
-
-[v1.3.0 - 2020年3月1日](https://github.com/apache/dubbo-go/releases/tag/v1.3.0)
-
-[v1.2.0 - 2019年11月15日](https://github.com/apache/dubbo-go/releases/tag/v1.2.0)
-
-[v1.1.0 - 2019年9月7日
捐献给Apache之后的第一次release](https://github.com/apache/dubbo-go/releases/tag/v1.1.0)
-
-[v1.0.0 - 2019年5月29日 兼容dubbo v2.6.5
版本](https://github.com/apache/dubbo-go/releases/tag/v1.0.0)
-
-## 工程架构 ##
-
-基于dubbo的extension模块和分层的代码设计(包括 protocol layer, registry layer, cluster layer,
config 等等)。我们的目标是：你可以对这些分层接口进行新的实现，并通过调用 extension 模块的“ extension.SetXXX ”方法来覆盖
dubbo-go [同 go-for-apache-dubbo ]的默认实现，以完成自己的特殊需求而无需修改源代码。同时，欢迎你为社区贡献有用的拓展实现。
-
-
-
-关于详细设计请阅读 [code layered
design](https://github.com/apache/dubbo-go/wiki/dubbo-go-V1.0-design)
-
-## 功能列表 ##
-
-实现列表:
-
-- 角色端
- * Consumer
- * Provider
-
-- 传输协议
- * HTTP
- * TCP
-
-- 序列化协议
- * JsonRPC V2
- * Hessian V2
- * [json for grpc](https://github.com/apache/dubbo-go/pull/582)
- * protobuf
-
-- 协议
- * Dubbo
- * [Triple](https://github.com/dubbogo/triple)
- * Jsonrpc2.0
- * [gRPC](https://github.com/apache/dubbo-go/pull/311)
- * [RESTful](https://github.com/apache/dubbo-go/pull/352)
-
-- 路由器
- * [Dubbo3统一路由规则](https://github.com/apache/dubbo-go/pull/1187)
-
-- 注册中心
- * ZooKeeper
- * [etcd v3](https://github.com/apache/dubbo-go/pull/148)
- * [nacos](https://github.com/apache/dubbo-go/pull/151)
- * [consul](https://github.com/apache/dubbo-go/pull/121)
- * [k8s](https://github.com/apache/dubbo-go/pull/400)
-
-- 动态配置中心与服务治理配置器
- * Zookeeper
- * [apollo](https://github.com/apache/dubbo-go/pull/250)
- * [nacos](https://github.com/apache/dubbo-go/pull/357)
-
-- 集群策略
- * Failover
- * [Failfast](https://github.com/apache/dubbo-go/pull/140)
- * [Failsafe/Failback](https://github.com/apache/dubbo-go/pull/136)
- * [Available](https://github.com/apache/dubbo-go/pull/155)
- * [Broadcast](https://github.com/apache/dubbo-go/pull/158)
- * [Forking](https://github.com/apache/dubbo-go/pull/161)
-
-- 负载均衡策略
- * Random
- * [RoundRobin](https://github.com/apache/dubbo-go/pull/66)
- * [LeastActive](https://github.com/apache/dubbo-go/pull/65)
- * [ConsistentHash](https://github.com/apache/dubbo-go/pull/261)
-
-- 过滤器
- * Echo Health Check
- * [服务熔断&降级](https://github.com/apache/dubbo-go/pull/133)
- * [TokenFilter](https://github.com/apache/dubbo-go/pull/202)
- * [AccessLogFilter](https://github.com/apache/dubbo-go/pull/214)
- * [TpsLimitFilter](https://github.com/apache/dubbo-go/pull/237)
- * [ExecuteLimitFilter](https://github.com/apache/dubbo-go/pull/246)
- * [GenericServiceFilter](https://github.com/apache/dubbo-go/pull/291)
- * [Auth/Sign](https://github.com/apache/dubbo-go/pull/323)
- * [Metrics filter](https://github.com/apache/dubbo-go/pull/342)
- * [Tracing filter](https://github.com/apache/dubbo-go/pull/335)
-
-- 调用
- * [泛化调用](https://github.com/apache/dubbo-go/pull/122)
-
-- 监控
- * Opentracing API
- * [Prometheus](https://github.com/apache/dubbo-go/pull/342)
-
-- Tracing
- * [For jsonrpc](https://github.com/apache/dubbo-go/pull/335)
- * [For dubbo](https://github.com/apache/dubbo-go/pull/344)
- * [For grpc](https://github.com/apache/dubbo-go/pull/397)
-
-- 元数据中心
- * [Nacos(Local)](https://github.com/apache/dubbo-go/pull/522)
- * [Zookeeper(Local)](https://github.com/apache/dubbo-go/pull/633)
- *
[Etcd(Local)](https://github.com/apache/dubbo-go/blob/9a5990d9a9c3d5e6633c0d7d926c156416bcb931/metadata/report/etcd/report.go)
- * [Consul(Local)](https://github.com/apache/dubbo-go/pull/633)
- * [Zookeeper(Remoting)](https://github.com/apache/dubbo-go/pull/1161)
-
-- 工具箱
- * [Dubbo-go-cli](https://github.com/apache/dubbo-go/pull/818)
-
-你可以通过访问 [roadmap](https://github.com/apache/dubbo-go/wiki/Roadmap) 知道更多关于
dubbo-go 的信息。
-
-
-
-## 文档
-
-请访问 [dubbo官方文档中关于 dubbo-go 的系列文档](http://dubbo.apache.org/zh/blog/) 或
[过往dubbo-go文档列表](http://alexstocks.github.io/html/dubbogo.html)。
-
-## 快速开始 ##
-
-[dubbo-samples/golang](https://github.com/apache/dubbo-go-samples)这个项目的事例展示了如何使用
dubbo-go 。请仔细阅读
[dubbo-samples/golang/README.md](https://github.com/apache/dubbo-go-samples/blob/master/README.md)
学习如何处理配置并编译程序。
-
-## 运行单测
-
-### 执行全部校验
-
-```bash
-make verify
-```
-
-### 校验许可证
-
-```bash
-make license
```
-
-### 执行单元测试
-
-```bash
-make test
+go get dubbo.apache.org/dubbo-go/v3
```
-## 编译
+### 下一步
-请移步 [dubbo-go-samples](https://github.com/apache/dubbo-go-samples)
+- [Dubbo-go 样例](https://github.com/apache/dubbo-go-samples):
该项目提供了一系列的样例，以展示Dubbo-go的每一项特性以及帮助你将Dubbo-go集成到你的系统中。
+- Dubbo-go 快速开始: [中文
🇨🇳](https://dubbogo.github.io/zh-cn/docs/user/quickstart/3.0/quickstart.html),
[English 🇺🇸](https://dubbogo.github.io/en-us/docs/user/quick-start.html)
+- [Dubbo-go 基准测试](https://github.com/dubbogo/dubbo-go-benchmark)
+- [Dubbo-go 百科](https://github.com/apache/dubbo-go/wiki)
## 如何贡献
-如果您愿意给 [Apache/dubbo-go](https://github.com/apache/dubbo-go)
贡献代码或者文档，我们都热烈欢迎。具体请参考 [contribution
intro](https://github.com/apache/dubbo-go/blob/master/contributing.md)。
-
-## 社区
-
-如果想访问官方钉钉群，请在钉钉中搜索社区群号 31363295 或者
扫描如下[二维码](https://mmbiz.qpic.cn/mmbiz_jpg/yvBJb5IiafvnHVBdtia30dxA2hKotr9DEckWsZ7aOJcDWDaSVMGwLmYv8GRgIQtqb4C2svicp8nVkMmGy7yKC5tyA/640?wx_fmt=jpeg&tp=webp&wxfrom=5&wx_lazy=1&wx_co=1)。
-
-<div>
-<table>
- <tbody>
- <tr></tr>
- <tr>
- <td align="center" valign="middle">
- <a href="http://alexstocks.github.io/html/dubbogo.html";
target="_blank">
- <img width="80px" height="85px"
src="./doc/pic/misc/dubbogo-dingding.png">
- </a>
- </td>
- </tr>
- <tr></tr>
- </tbody>
-</table>
-</div>
-
-dubbogo 社区已经开通微信公众号，可在微信搜索 "dubbogo示土区" 或者扫描如下二维码关注，可通过公众号私信留言加入 dubbogo 微信社区。
-
-<div>
-<table>
- <tbody>
- <tr></tr>
- <tr>
- <td align="center" valign="middle">
- <img width="80px" height="115px"
src="./doc/pic/misc/dubbogo-wechat.png">
- </a>
- </td>
- </tr>
- <tr></tr>
- </tbody>
-</table>
-</div>
+请访问[CONTRIBUTING](./CONTRIBUTING.md)来了解如何提交更新以及贡献工作流。
-作为一个维护已经帮助构建了经受多家大型微服务系统的社区，我们足以为现有的成绩感到自豪。社区欢迎能提出建设性意见者，只知索取者和喷子请绕行。
+## 报告问题
-## 性能测试 ##
+请使用[bug report 模板](issues/new?template=bug-report.md)报告错误，使用[enhancement
模版](issues/new?template=enhancement.md)提交改进建议。
-性能测试项目是 [dubbo-go-benchmark](https://github.com/dubbogo/dubbo-go-benchmark)。
+## 联系
-关于 dubbo-go 性能测试报告，请阅读 [dubbo benchmarking
report](https://github.com/apache/dubbo-go/wiki/Benchmark-test-of-dubbo) &
[jsonrpc benchmarking
report](https://github.com/apache/dubbo-go/wiki/Benchmark-test-of-jsonrpc)。
+- [钉钉群](https://www.dingtalk.com/): 23331795
-## [User List](https://github.com/apache/dubbo-go/issues/2)
+## [用户列表](https://github.com/apache/dubbo-go/issues/2)
若你正在使用 [apache/dubbo-go](https://github.com/apache/dubbo-go)
且认为其有用或者想对其做改进，请添列贵司信息于
[用户列表](https://github.com/apache/dubbo-go/issues/2)，以便我们知晓。
@@ -312,5 +156,8 @@ dubbogo 社区已经开通微信公众号，可在微信搜索 "dubbogo示土区
</table>
</div>
-[更多用户示例](https://github.com/apache/dubbo-go/issues/2)
+[查看更多用户示例](https://github.com/apache/dubbo-go/issues/2)
+
+## 许可证
+Apache Dubbo-go使用Apache许可证2.0版本，请参阅LICENSE文件了解更多。
