This is an automated email from the ASF dual-hosted git repository.
liujun pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/dubbo-website.git
The following commit(s) were added to refs/heads/master by this push:
new 1a96d66 update migration doc (#810)
1a96d66 is described below
commit 1a96d66cf33bf7d922bac857358dd8a78f95aeae
Author: ken.lj <[email protected]>
AuthorDate: Fri May 28 17:11:26 2021 +0800
update migration doc (#810)
---
.../3x-migration-and-compatibility-guide.md | 32 ----------------------
content/zh/docs/v3.0/migration/_index.md | 31 ++++++++++++++++++++-
.../docs/v3.0/migration/migration-routingrule.md | 11 +++++++-
.../v3.0/migration/migration-service-discovery.md | 8 ++++++
content/zh/docs/v3.0/migration/migration-triple.md | 10 ++++++-
5 files changed, 57 insertions(+), 35 deletions(-)
diff --git
a/content/zh/docs/v3.0/migration/3x-migration-and-compatibility-guide.md
b/content/zh/docs/v3.0/migration/3x-migration-and-compatibility-guide.md
deleted file mode 100644
index 89dd230..0000000
--- a/content/zh/docs/v3.0/migration/3x-migration-and-compatibility-guide.md
+++ /dev/null
@@ -1,32 +0,0 @@
-# 3.x 版本升级与兼容性
-
-**无需改动任何代码，直接升级到 Dubbo 3.0。**
-
-在 3.0 版本的设计与开发之初，我们就定下了兼容老版本 Dubbo 用户（2.5、2.6、2.7）的目标。因此，往 3.0
版本的升级过程将会是完全透明的，用户无需做任何业务改造，升级 3.x 后的框架行为将保持与 2.x 版本完全一致。
-
-```xml
-<dependency>
- <groupId>org.apache.dubbo</groupId>
- <artifactId>dubbo</artifactId>
- <version>3.0.0</version>
-</dependency>
-```
-
-
-但也要注意，透明升级仅仅是通往 3.0 的第一步，因为 "框架行为保持一致" 也就意味着用户将无法体验到 3.0 的新特性。**如果要启用 3.0
的带来的新特性，用户则需要进行一定的改造，我们称这个过程为迁移，这是一个按需开启的过程。**
-
-
-
-因此，对老用户而言，有两条不同的迁移路径：
-
-* **分两步走，先以兼容模式推动业务升级到 3.0 版本（无需改造），之后在某些时机按需启用新特性（按需改造）；**
-* **升级与迁移同步完成，在业务升级到 3.0 版本的同时，完成改造并启用新特性；**
-
-
-
-Dubbo 3.0 提供的新特性包括：
-
-* **新的地址发现模型（应用级服务发现）。**查看应用级服务发现的迁移步骤，查看应用级服务发现的使用方式，查看应用级服务发现设计与实现。
-* **下一代基于 HTTP/2 的 Triple 协议。**查看 Triple 协议迁移步骤，查看 Triple 协议使用方式，查看 Triple
协议设计与实现。
-* **统一的路由规则。**查看统一路由规则的迁移步骤，查看统一路由规则使用方式，查看统一路由规则设计与实现。
-
diff --git a/content/zh/docs/v3.0/migration/_index.md
b/content/zh/docs/v3.0/migration/_index.md
index 4d0f007..edd2ea4 100755
--- a/content/zh/docs/v3.0/migration/_index.md
+++ b/content/zh/docs/v3.0/migration/_index.md
@@ -8,6 +8,35 @@ description: "Dubbo 3.0 升级指南"
---
{{% pageinfo %}}
-Dubbo 3.0 升级指南
+
+**无需改动任何代码，直接升级到 Dubbo 3.0。**
+
+在 3.0 版本的设计与开发之初，我们就定下了兼容老版本 Dubbo 用户（2.5、2.6、2.7）的目标。因此，往 3.0
版本的升级过程将会是完全透明的，用户无需做任何业务改造，升级 3.x 后的框架行为将保持与 2.x 版本完全一致。
+
+```xml
+<dependency>
+ <groupId>org.apache.dubbo</groupId>
+ <artifactId>dubbo</artifactId>
+ <version>3.0.0</version>
+</dependency>
+```
+
+
+但也要注意，透明升级仅仅是通往 3.0 的第一步，因为 "框架行为保持一致" 也就意味着用户将无法体验到 3.0 的新特性。**如果要启用 3.0
的带来的新特性，用户则需要进行一定的改造，我们称这个过程为迁移，这是一个按需开启的过程。**
+
+
+
+因此，对老用户而言，有两条不同的迁移路径：
+
+* **分两步走，先以兼容模式推动业务升级到 3.0 版本（无需改造），之后在某些时机按需启用新特性（按需改造）；**
+* **升级与迁移同步完成，在业务升级到 3.0 版本的同时，完成改造并启用新特性；**
+
+
+
+Dubbo 3.0 提供的新特性包括：
+
+* **新的地址发现模型（应用级服务发现）。**
查看[应用级服务发现的迁移步骤](./migration-service-discovery.md)，查看[应用级服务发现的使用方式]()，查看[应用级服务发现设计与实现]()。
+* **下一代基于 HTTP/2 的 Triple 协议。** 查看[Triple 协议迁移步骤](./migration-triple.md)，查看
[Triple 协议使用方式](../references/tri.md)，查看 Triple 协议设计与实现。
+* **统一的路由规则。**
查看[统一路由规则的迁移步骤](./migration-routingrule.md)，查看[统一路由规则使用方式](../references/routerule.md)，查看统一路由规则设计与实现。
{{% /pageinfo %}}
diff --git a/content/zh/docs/v3.0/migration/migration-routingrule.md
b/content/zh/docs/v3.0/migration/migration-routingrule.md
index e871685..67770ec 100644
--- a/content/zh/docs/v3.0/migration/migration-routingrule.md
+++ b/content/zh/docs/v3.0/migration/migration-routingrule.md
@@ -1 +1,10 @@
-# 统一路由规则升级指南
\ No newline at end of file
+---
+type: docs
+title: "统一路由规则升级指南"
+linkTitle: "统一路由规则升级指南"
+weight: 12
+description: "统一路由规则升级指南"
+---
+
+# 统一路由规则升级指南
+
diff --git a/content/zh/docs/v3.0/migration/migration-service-discovery.md
b/content/zh/docs/v3.0/migration/migration-service-discovery.md
index bfda738..86161d5 100644
--- a/content/zh/docs/v3.0/migration/migration-service-discovery.md
+++ b/content/zh/docs/v3.0/migration/migration-service-discovery.md
@@ -1,3 +1,11 @@
+---
+type: docs
+title: "应用级地址发现迁移指南"
+linkTitle: "应用级地址发现迁移指南"
+weight: 12
+description: "应用级地址发现迁移指南"
+---
+
# 应用级地址发现迁移指南
本文档专门针对使用 2.x 版本的老用户，详细阐述了升级到 3.x 后的默认地址注册与发现行为、如何平滑的迁移到新版本的地址模型。
diff --git a/content/zh/docs/v3.0/migration/migration-triple.md
b/content/zh/docs/v3.0/migration/migration-triple.md
index 11d6ac1..2844a0b 100644
--- a/content/zh/docs/v3.0/migration/migration-triple.md
+++ b/content/zh/docs/v3.0/migration/migration-triple.md
@@ -1 +1,9 @@
-# Triple 协议迁移指南
+---
+type: docs
+title: "Triple协议迁移指南"
+linkTitle: "Triple协议迁移指南"
+weight: 12
+description: "Triple协议迁移指南"
+---
+
+# Triple协议迁移指南
