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 127dc44 try new migration doc organization
127dc44 is described below
commit 127dc44ff7c56abdbf220d811c939bc059c2cac8
Author: ken.lj <[email protected]>
AuthorDate: Fri May 28 17:22:49 2021 +0800
try new migration doc organization
---
content/zh/docs/v3.0/migration/_index.md | 36 +++-------------------
.../docs/v3.0/migration/migration-routingrule.md | 2 +-
.../v3.0/migration/migration-service-discovery.md | 6 ++--
content/zh/docs/v3.0/migration/migration-triple.md | 2 +-
...dex.md => v3-migration-and-compatibility-guide} | 28 +++++++++--------
5 files changed, 24 insertions(+), 50 deletions(-)
diff --git a/content/zh/docs/v3.0/migration/_index.md
b/content/zh/docs/v3.0/migration/_index.md
index edd2ea4..2dbe681 100755
--- a/content/zh/docs/v3.0/migration/_index.md
+++ b/content/zh/docs/v3.0/migration/_index.md
@@ -1,42 +1,14 @@
---
type: docs
-title: "Dubbo3.0 升级指南"
-linkTitle: "Dubbo3.0 升级指南"
+title: "升级与兼容性"
+linkTitle: "升级与兼容性"
weight: 20
-description: "Dubbo 3.0 升级指南"
+description: "如果你是老版本的 Dubbo 用户，请在此了解如何升级到 Dubbo3 版本。"
---
{{% pageinfo %}}
-**无需改动任何代码，直接升级到 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 %}}
+~~~~
\ No newline at end of file
diff --git a/content/zh/docs/v3.0/migration/migration-routingrule.md
b/content/zh/docs/v3.0/migration/migration-routingrule.md
index 67770ec..9695ee3 100644
--- a/content/zh/docs/v3.0/migration/migration-routingrule.md
+++ b/content/zh/docs/v3.0/migration/migration-routingrule.md
@@ -1,7 +1,7 @@
---
type: docs
title: "统一路由规则升级指南"
-linkTitle: "统一路由规则升级指南"
+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 86161d5..f97f15c 100644
--- a/content/zh/docs/v3.0/migration/migration-service-discovery.md
+++ b/content/zh/docs/v3.0/migration/migration-service-discovery.md
@@ -1,15 +1,13 @@
---
type: docs
title: "应用级地址发现迁移指南"
-linkTitle: "应用级地址发现迁移指南"
+linkTitle: "应用级地址发现"
weight: 12
-description: "应用级地址发现迁移指南"
+description: "本文档专门针对使用 2.x 版本的老用户，详细阐述了升级到 3.x
后的默认地址注册与发现行为、如何平滑的迁移到新版本的地址模型。"
---
# 应用级地址发现迁移指南
-本文档专门针对使用 2.x 版本的老用户，详细阐述了升级到 3.x 后的默认地址注册与发现行为、如何平滑的迁移到新版本的地址模型。
-
**总体上来说，在地址注册与发现环节，3.x 是完全兼容 2.x 版本的，这意味着，用户可以选择将集群内任意数量的应用或机器升级到
3.x，同时在这个过程中保持与 2.x 版本的互操作性。**
diff --git a/content/zh/docs/v3.0/migration/migration-triple.md
b/content/zh/docs/v3.0/migration/migration-triple.md
index 2844a0b..e671f41 100644
--- a/content/zh/docs/v3.0/migration/migration-triple.md
+++ b/content/zh/docs/v3.0/migration/migration-triple.md
@@ -1,7 +1,7 @@
---
type: docs
title: "Triple协议迁移指南"
-linkTitle: "Triple协议迁移指南"
+linkTitle: "Triple"
weight: 12
description: "Triple协议迁移指南"
---
diff --git a/content/zh/docs/v3.0/migration/_index.md
b/content/zh/docs/v3.0/migration/v3-migration-and-compatibility-guide
old mode 100755
new mode 100644
similarity index 59%
copy from content/zh/docs/v3.0/migration/_index.md
copy to content/zh/docs/v3.0/migration/v3-migration-and-compatibility-guide
index edd2ea4..9381012
--- a/content/zh/docs/v3.0/migration/_index.md
+++ b/content/zh/docs/v3.0/migration/v3-migration-and-compatibility-guide
@@ -1,14 +1,11 @@
-
---
type: docs
-title: "Dubbo3.0 升级指南"
-linkTitle: "Dubbo3.0 升级指南"
-weight: 20
-description: "Dubbo 3.0 升级指南"
+title: "3.x 升级与兼容性指南"
+linkTitle: "总结"
+weight: 12
+description: ""
---
-{{% pageinfo %}}
-
**无需改动任何代码，直接升级到 Dubbo 3.0。**
在 3.0 版本的设计与开发之初，我们就定下了兼容老版本 Dubbo 用户（2.5、2.6、2.7）的目标。因此，往 3.0
版本的升级过程将会是完全透明的，用户无需做任何业务改造，升级 3.x 后的框架行为将保持与 2.x 版本完全一致。
@@ -35,8 +32,15 @@ description: "Dubbo 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 %}}
-
+* **新的地址发现模型（应用级服务发现）。**
+ * 查看[应用级服务发现的迁移步骤](./migration-service-discovery.md)
+ * 查看[应用级服务发现的使用方式]()
+ * 查看[应用级服务发现设计与实现]()。
+* **下一代基于 HTTP/2 的 Triple 协议。**
+ * 查看[Triple 协议迁移步骤](./migration-triple.md)
+ * 查看 [Triple 协议使用方式](../references/tri.md)
+ * 查看 Triple 协议设计与实现。
+* **统一的路由规则。**
+ * 查看[统一路由规则的迁移步骤](./migration-routingrule.md)
+ * 查看[统一路由规则使用方式](../references/routerule.md)
+ * 查看统一路由规则设计与实现
\ No newline at end of file
