diff --git a/doc/docs/_sidebar.md b/doc/docs/_sidebar.md
index f62469f7..b0701362 100644
--- a/doc/docs/_sidebar.md
+++ b/doc/docs/_sidebar.md
@@ -1,35 +1,36 @@
-* [首页](/?t=1578663129148)
+* [首页](/?t=1578910309712)
 * 开发文档
-  * [快速体验](files/10010_快速体验.md?t=1578663129153)
-  * [项目接入到SOP](files/10011_项目接入到SOP.md?t=1578663129189)
-  * [新增接口](files/10020_新增接口.md?t=1578663129189)
-  * [开发流程](files/10021_开发流程.md?t=1578663129189)
-  * [业务参数校验](files/10030_业务参数校验.md?t=1578663129189)
-  * [错误处理](files/10040_错误处理.md?t=1578663129190)
-  * [编写文档](files/10041_编写文档.md?t=1578663129190)
-  * [接口交互详解](files/10050_接口交互详解.md?t=1578663129190)
-  * [easyopen支持](files/10070_easyopen支持.md?t=1578663129191)
-  * [使用签名校验工具](files/10080_使用签名校验工具.md?t=1578663129191)
-  * [ISV管理](files/10085_ISV管理.md?t=1578663129191)
-  * [自定义返回结果](files/10087_自定义返回结果.md?t=1578663129191)
-  * [自定义过滤器](files/10088_自定义过滤器.md?t=1578663129191)
-  * [自定义校验token](files/10089_自定义校验token.md?t=1578663129191)
-  * [路由授权](files/10090_路由授权.md?t=1578663129191)
-  * [接口限流](files/10092_接口限流.md?t=1578663129192)
-  * [监控日志](files/10093_监控日志.md?t=1578663129192)
-  * [SDK开发](files/10095_SDK开发.md?t=1578663129192)
-  * [使用SpringCloudGateway](files/10096_使用SpringCloudGateway.md?t=1578663129192)
-  * [应用授权](files/10097_应用授权.md?t=1578663129192)
-  * [提供restful接口](files/10100_提供restful接口.md?t=1578663129192)
-  * [文件上传](files/10104_文件上传.md?t=1578663129192)
-  * [配置Sleuth链路追踪](files/10109_配置Sleuth链路追踪.md?t=1578663129193)
-  * [预发布灰度发布](files/10110_预发布灰度发布.md?t=1578663129193)
-  * [动态修改请求参数](files/10111_动态修改请求参数.md?t=1578663129193)
-  * [使用eureka](files/10112_使用eureka.md?t=1578663129193)
-  * [扩展其它注册中心](files/10113_扩展其它注册中心.md?t=1578663129193)
+  * [快速体验](files/10010_快速体验.md?t=1578910309714)
+  * [项目接入到SOP](files/10011_项目接入到SOP.md?t=1578910309731)
+  * [新增接口](files/10020_新增接口.md?t=1578910309732)
+  * [开发流程](files/10021_开发流程.md?t=1578910309732)
+  * [业务参数校验](files/10030_业务参数校验.md?t=1578910309732)
+  * [错误处理](files/10040_错误处理.md?t=1578910309732)
+  * [编写文档](files/10041_编写文档.md?t=1578910309732)
+  * [接口交互详解](files/10050_接口交互详解.md?t=1578910309732)
+  * [easyopen支持](files/10070_easyopen支持.md?t=1578910309732)
+  * [使用签名校验工具](files/10080_使用签名校验工具.md?t=1578910309732)
+  * [ISV管理](files/10085_ISV管理.md?t=1578910309732)
+  * [自定义返回结果](files/10087_自定义返回结果.md?t=1578910309733)
+  * [自定义过滤器](files/10088_自定义过滤器.md?t=1578910309733)
+  * [自定义校验token](files/10089_自定义校验token.md?t=1578910309733)
+  * [路由授权](files/10090_路由授权.md?t=1578910309733)
+  * [接口限流](files/10092_接口限流.md?t=1578910309733)
+  * [监控日志](files/10093_监控日志.md?t=1578910309733)
+  * [SDK开发](files/10095_SDK开发.md?t=1578910309733)
+  * [使用SpringCloudGateway](files/10096_使用SpringCloudGateway.md?t=1578910309733)
+  * [应用授权](files/10097_应用授权.md?t=1578910309733)
+  * [提供restful接口](files/10100_提供restful接口.md?t=1578910309733)
+  * [文件上传](files/10104_文件上传.md?t=1578910309734)
+  * [配置Sleuth链路追踪](files/10109_配置Sleuth链路追踪.md?t=1578910309734)
+  * [预发布灰度发布](files/10110_预发布灰度发布.md?t=1578910309734)
+  * [动态修改请求参数](files/10111_动态修改请求参数.md?t=1578910309734)
+  * [使用eureka](files/10112_使用eureka.md?t=1578910309734)
+  * [扩展其它注册中心](files/10113_扩展其它注册中心.md?t=1578910309734)
 * 原理分析
-  * [原理分析之@ApiMapping](files/90010_原理分析之@ApiMapping.md?t=1578663129194)
-  * [原理分析之如何存储路由](files/90011_原理分析之如何存储路由.md?t=1578663129194)
-  * [原理分析之如何路由](files/90012_原理分析之如何路由.md?t=1578663129194)
-  * [原理分析之文档归纳](files/90013_原理分析之文档归纳.md?t=1578663129194)
-  * [常见问题](files/90100_常见问题.md?t=1578663129194)
+  * [原理分析之@ApiMapping](files/90010_原理分析之@ApiMapping.md?t=1578910309734)
+  * [原理分析之如何存储路由](files/90011_原理分析之如何存储路由.md?t=1578910309734)
+  * [原理分析之如何路由](files/90012_原理分析之如何路由.md?t=1578910309734)
+  * [原理分析之文档归纳](files/90013_原理分析之文档归纳.md?t=1578910309734)
+  * [2.x升3.x注意事项](files/90014_2.x升3.x注意事项.md?t=1578910309734)
+  * [常见问题](files/90100_常见问题.md?t=1578910309734)
diff --git a/doc/docs/files/90014_2.x升3.x注意事项.md b/doc/docs/files/90014_2.x升3.x注意事项.md
new file mode 100644
index 00000000..1cf1d194
--- /dev/null
+++ b/doc/docs/files/90014_2.x升3.x注意事项.md
@@ -0,0 +1,23 @@
+# 2.x升3.x注意事项
+
+升级到3.x后`本地访问接口`方式会有不同。
+
+```java
+@ApiMapping(value = "alipay.story.get")
+public StoryResult getStory(StoryParam param) {
+    StoryResult story = new StoryResult();
+    story.setId(1L);
+    story.setName("海底小纵队(alipay.story.get1.0), port:" + environment.getProperty("server.port") + ", param:" + param);
+    return story;
+}
+```
+
+- 2.x版本访问方式：
+
+`http://localhost:2222/alipay.story.get/?name=Jim&version=1.0`
+
+- 3.x版本访问方式：
+
+`http://localhost:2222/alipay.story.get/1.0/?name=Jim`
+
+3.x版本中把版本号融合在了url中，如果这个功能没有用到，可以放心升级。
\ No newline at end of file