diff --git a/diboot-docs/.vuepress/config.js b/diboot-docs/.vuepress/config.js
index fa44847..b1d1970 100644
--- a/diboot-docs/.vuepress/config.js
+++ b/diboot-docs/.vuepress/config.js
@@ -95,14 +95,23 @@ module.exports = {
                     ]
                 }
             ],
-            '/guide/notes/': [
+            '/guide/notes/faq': [
                 {
-                    title: '版本升级&FAQ',
+                    title: 'FAQ',
                     collapsable: true,
                     sidebarDepth: 2,
                     children: [
-                        ['/guide/notes/upgrade', '版本升级指南'],
-                        ['/guide/notes/faq', 'FAQ'],
+                        ['/guide/notes/faq/main', 'FAQ'],
+                    ]
+                }
+            ],
+            '/guide/notes/upgrade': [
+                {
+                    title: '版本升级指南',
+                    collapsable: true,
+                    sidebarDepth: 2,
+                    children: [
+                        ['/guide/notes/upgrade/2_0_x升级至2_1_x', '2.0.x升级至2.1.x'],
                     ]
                 }
             ]
@@ -115,8 +124,8 @@ module.exports = {
                 { text: 'core基础内核', link: '/guide/diboot-core/设计理念' },
                 { text: 'IAM身份认证', link: '/guide/diboot-iam/介绍' },
                 { text: 'File文件组件', link: '/guide/diboot-file/介绍' },
-                { text: '版本升级指南', link: '/guide/notes/upgrade' },
-                { text: 'F&Q', link: '/guide/notes/faq' },
+                { text: '版本升级指南', link: '/guide/notes/upgrade/2_0_x升级至2_1_x' },
+                { text: 'F&Q', link: '/guide/notes/faq/main' },
             ]
         }, {
             text: '前端项目 指南',
diff --git a/diboot-docs/guide/notes/faq.md b/diboot-docs/guide/notes/faq/main.md
similarity index 100%
rename from diboot-docs/guide/notes/faq.md
rename to diboot-docs/guide/notes/faq/main.md
diff --git a/diboot-docs/guide/notes/upgrade.md b/diboot-docs/guide/notes/upgrade/2_0_x升级至2_1_x.md
similarity index 98%
rename from diboot-docs/guide/notes/upgrade.md
rename to diboot-docs/guide/notes/upgrade/2_0_x升级至2_1_x.md
index f054699..25cd211 100644
--- a/diboot-docs/guide/notes/upgrade.md
+++ b/diboot-docs/guide/notes/upgrade/2_0_x升级至2_1_x.md
@@ -1,8 +1,6 @@
-## v2.0.x 升级至 v2.1.x
+## 组件更改说明
 
-### 组件更改说明
-
-#### 1. diboot-core：
+### diboot-core
 * v2.1.x 版本开始，BaseCrudRestController移除了方法中的request参数，改为在BaseController中统一注入，以简化继承代码。
 子类需要时直接用request变量即可，无需再定义request参数。
 修改: 调用父类方法的Controller方法，需删除方法中的request参数定义及传递。
@@ -63,7 +61,7 @@ devtools从2.1版本开始不再支持extdata的特殊处理。
 
 * v2.1.x版本依赖组件升级为: Spring Boot 2.3.x，Mybatis-Plus 3.3.x，fastjson 1.2.7x。根据您的依赖情况，可能会有依赖冲突需要解决。
 
-#### 2. diboot-devtools
+### diboot-devtools
 * v2.1版本开始，配置参数：
 新增 **diboot.devtools.output-path** 代码的生成根路径配置项，
 如entity, dto, controller, mapper, service, vo等路径无自定义需求，仅配置该根路径即可。
@@ -84,9 +82,8 @@ v2.1.x版本开始支持前端代码生成，如果需要该功能，则需配
 diboot.devtools.output-path-frontend=/Workspace/diboot-antd-admin-ent/
 ~~~
 
-#### 3. diboot-iam
 
-### 升级实操指南
+## 升级实操指南
 
 > 将diboot所有的组件版本号替换至2.1.x的最新版本，然后按照下述内容进行相关更改即可。
 
@@ -94,7 +91,7 @@ diboot.devtools.output-path-frontend=/Workspace/diboot-antd-admin-ent/
 注：后端项目升级完成后，需要重新生成基础代码（在此过程中，如果对旧版本基础代码有更改，则需要对旧版本基础代码做一个备份），2.1.x版本已经不再从启动时候自动生成初始代码了，需要您手动到diboot devtools中的初始化页面进行手动生成。
 :::
 
-#### 1. SpringBoot版本：
+### 1. SpringBoot版本调整
 
 * 2.1.x已支持SpringBoot2.3.x版本，请先升级SpringBoot版本为2.3.x
 * 更改spring-boot-starter-test依赖项，如下：
@@ -112,7 +109,7 @@ diboot.devtools.output-path-frontend=/Workspace/diboot-antd-admin-ent/
 </dependency>
 ```
 
-#### Controller文件相关更改：
+### 2. 所有Controller代码调整
 * 更改BaseCustomCrudRestController类的传入参数，如下：
 ```java
 public class BaseCustomCrudRestController<E extends BaseEntity, VO extends Serializable> extends BaseCrudRestController {
@@ -191,7 +188,7 @@ public JsonResult deleteEntityMapping(@PathVariable("id")Long id) throws Excepti
 注：后端项目升级完成后，需要重新生成基础代码（在此过程中，如果对旧版本基础代码有更改，则需要对旧版本基础代码做一个备份），2.1.x版本已经不再从启动时候自动生成初始代码了，需要您手动到diboot devtools中的初始化页面进行手动生成。
 :::
 
-#### diboot-antd-admin前端项目升级
+### 3. diboot-antd-admin前端调整
 > 前端项目需要先从github的release notes中下载一个2.1.0版本的源码包，以下升级流程将依赖于此源码包。
 
 * 先更新package.json依赖到最2.1.0版本的依赖，具体如下：