From 448584a146de7b13ef85ebf745e940eec1ba1cc0 Mon Sep 17 00:00:00 2001
From: chenjiahan <chenjiahan@youzan.com>
Date: Sun, 9 Aug 2020 20:49:01 +0800
Subject: [PATCH] docs: add changelog-v3

---
 breaking-changes.md                 | 43 -------------------
 docs/markdown/changelog-v3.zh-CN.md | 64 +++++++++++++++++++++++++++++
 vant.config.js                      |  2 +-
 3 files changed, 65 insertions(+), 44 deletions(-)
 create mode 100644 docs/markdown/changelog-v3.zh-CN.md

diff --git a/breaking-changes.md b/breaking-changes.md
index e2350b66d..e69de29bb 100644
--- a/breaking-changes.md
+++ b/breaking-changes.md
@@ -1,43 +0,0 @@
-# 不兼容更新
-
-## v-model API 变更
-
-以下改动是为了适配 Vue 3 的 v-model API 用法变更：
-
-- Tabs: `v-model` 重命名为 `v-model:active`
-- Popup: `v-model` 重命名为 `v-model:show`
-- Circle: `v-model` 重命名为 `v-model:currentRate`
-- Dialog: `v-model` 重命名为 `v-model:show`
-- ShareSheet: `v-model` 重命名为 `v-model:show`
-- ActionSheet: `v-model` 重命名为 `v-model:show`
-- List: `v-model` 重命名为 `v-model:loading`，`error.sync` 重命名为 `v-model:error`
-- Field: v-model 对应的属性 `value` 重命名为 `modelValue`，事件由 `input` 重命名为 `update:modelValue`
-- Switch: v-model 对应的属性 `value` 重命名为 `modelValue`，事件由 `input` 重命名为 `update:modelValue`
-- Sidebar: v-model 对应的属性 `activeKey` 重命名为 `modelValue`，事件由 `input` 重命名为 `update:modelValue`
-- TreeSelect: `active-id.sync` 重命名为 `v-model:active-id`
-- TreeSelect: `main-active-index.sync` 重命名为 `v-model:main-active-index`
-
-## API 命名调整
-
-以下改动是为了规范 API 命名：
-
-- TreeSelect: `navclick` 事件重命名为 `click-nav`
-- TreeSelect: `itemclick` 事件重命名为 `click-item`
-
-### 重命名徽标属性
-
-在之前的版本中，我们通过 info 属性来展示图标右上角的徽标信息，为了表达更符合社区的命名习惯，我们将这个属性重命名为 badge，影响以下组件：
-
-- Tab
-- Icon
-- GridItem
-- TreeSelect
-- TabbarItem
-- SidebarItem
-- GoodsActionIcon
-
-同时内部使用的 Info 组件也会重命名为 Badge。
-
-## 废弃个别组件
-
-- SwitchCell: 移除此组件，可以直接使用 Cell 和 Switch 组件代替
diff --git a/docs/markdown/changelog-v3.zh-CN.md b/docs/markdown/changelog-v3.zh-CN.md
new file mode 100644
index 000000000..f940e1491
--- /dev/null
+++ b/docs/markdown/changelog-v3.zh-CN.md
@@ -0,0 +1,64 @@
+# 更新日志
+
+### 提示
+
+当前文档为 Vant 3.x 版本的更新日志，如需查询 Vant 2.0 的更新内容，请访问 [Vant 2.0 更新日志](https://youzan.github.io/vant/#/zh-CN/changelog)。
+
+### 介绍
+
+Vant 遵循 [Semver](https://semver.org/lang/zh-CN/) 语义化版本规范。
+
+**发布节奏**
+
+- 修订号：每周发布，包含新特性和问题修复。
+- 次版本号：每隔一至二个月发布，包含新特性和较大的功能更新，向下兼容。
+- 主版本号：发布时间不定，包含不兼容更新。
+
+### v3.0.0-alpha.0
+
+`TODO`
+
+#### 不兼容更新
+
+##### v-model API 变更
+
+以下改动是为了适配 Vue 3 的 v-model API 用法变更：
+
+- Tabs: `v-model` 重命名为 `v-model:active`
+- Popup: `v-model` 重命名为 `v-model:show`
+- Circle: `v-model` 重命名为 `v-model:currentRate`
+- Dialog: `v-model` 重命名为 `v-model:show`
+- ShareSheet: `v-model` 重命名为 `v-model:show`
+- ActionSheet: `v-model` 重命名为 `v-model:show`
+- List: `v-model` 重命名为 `v-model:loading`，`error.sync` 重命名为 `v-model:error`
+- Field: v-model 对应的属性 `value` 重命名为 `modelValue`，事件由 `input` 重命名为 `update:modelValue`
+- Switch: v-model 对应的属性 `value` 重命名为 `modelValue`，事件由 `input` 重命名为 `update:modelValue`
+- Sidebar: v-model 对应的属性 `activeKey` 重命名为 `modelValue`，事件由 `input` 重命名为 `update:modelValue`
+- TreeSelect: `active-id.sync` 重命名为 `v-model:active-id`
+- TreeSelect: `main-active-index.sync` 重命名为 `v-model:main-active-index`
+
+##### API 命名调整
+
+以下改动是为了规范 API 命名：
+
+- Toast: `mask` 属性重命名为 `overlay`
+- TreeSelect: `navclick` 事件重命名为 `click-nav`
+- TreeSelect: `itemclick` 事件重命名为 `click-item`
+
+##### 重命名徽标属性
+
+在之前的版本中，我们通过 info 属性来展示图标右上角的徽标信息，为了表达更符合社区的命名习惯，我们将这个属性重命名为 badge，影响以下组件：
+
+- Tab
+- Icon
+- GridItem
+- TreeSelect
+- TabbarItem
+- SidebarItem
+- GoodsActionIcon
+
+同时内部使用的 Info 组件也会重命名为 Badge。
+
+##### 废弃组件
+
+- SwitchCell: 移除此组件，可以直接使用 Cell 和 Switch 组件代替
diff --git a/vant.config.js b/vant.config.js
index 337bc7f36..b687d8194 100644
--- a/vant.config.js
+++ b/vant.config.js
@@ -50,7 +50,7 @@ module.exports = {
                 title: '快速上手',
               },
               {
-                path: 'changelog',
+                path: 'changelog-v3',
                 title: '更新日志',
               },
               {