docs: some enhancements

Author: ulivz

packages/docs/docs/config/README.md

@@ -130,8 +130,7 @@ Create a `.vuepress/style/index.styl` file and it will be applied as global styl
 
 **Also see:**
 
-- [Why can't `palette.styl` and `index.styl` merge into one API?](faq/#why-can-t-palette-styl-and-index-styl-merge-into-one-api)
-- [Why can't `palette.styl` and `index.styl` merge into one API?](faq/#why-can-t-palette-styl-and-index-styl-merge-into-one-api)
+- [Why can't `palette.styl` and `index.styl` merge into one API?](../faq/README.md#why-can-t-palette-styl-and-index-styl-merge-into-one-api)
 
 ## Theming
 
@@ -160,11 +159,7 @@ Provide config options to the used theme. The options will vary depending on the
 - Type: `Object|Array`
 - Default: `undefined`
 
-For default usage, please refer to [plugin API](../plugin/README.md).
-
-::: tip
-There is a hidden feature. `.vuepress/config.js` also supports all [options](../plugin/README.md#options) of Plugin API.
-:::
+Please refer to [plugin API > Using a plugin](../plugin/README.md#using-a-plugin) to leran how to use a plugin.
 
 ## Markdown
 

packages/docs/docs/plugin/official.md

@@ -2,43 +2,41 @@
 sidebar: auto
 ---
 
-- TODO
-
 # Official Plugins
 
 ## @vuepress/search
 
-### Options
+- TODO
 
 ## @vuepress/pwa
 
-### Options
+- TODO
 
 ## @vuepress/blog
 
-### Options
+- TODO
 
 ## @vuepress/pagination
 
-### Options
+- TODO
 
 ## @vuepress/google-analytics
 
-### Options
+- TODO
 
 ## @vuepress/i18n-ui
 
-### Options
+- TODO
 
 ## @vuepress/last-updated
 
-### Options
+- TODO
 
 ## @vuepress/medium-zoom
 
-### Options
+- TODO
 
 ## @vuepress/back-to-top
 
-### Options
+- TODO
 

packages/docs/docs/theme/README.md

@@ -240,10 +240,3 @@ The plugin whose name starts with `@vuepress/theme-` is an officially maintained
 - Default: undefined
 
 See: [Config > plugins](../config/README.md#plugins).
-
-### palette
-
-- Type: `String|Object`
-- Default: undefined
-
-See: [Config > palette](../config/README.md#palette).

packages/docs/docs/zh/config/README.md

@@ -115,6 +115,20 @@ module.exports = {
 
 一个函数，用来控制对于哪些文件，是需要生成 `<link rel="prefetch">` 资源提示的。请参考 [shouldPrefetch](https://ssr.vuejs.org/zh/api/#shouldpreload)。
 
+## 样式
+
+### palette.styl
+
+创建一个 `.vuepress/style/palette.styl` 文件，其会被自动注册为全局调色板。
+
+### index.styl
+
+创建一个 `.vuepress/style/index.styl` 文件， 其会被自动应用为全局样式
+
+**Also see:**
+
+- [Why can't `palette.styl` and `index.styl` merge into one API?](../faq/README.md#why-can-t-palette-styl-and-index-styl-merge-into-one-api)
+
 ## 主题
 
 ### theme
@@ -135,6 +149,15 @@ module.exports = {
 
 - [默认主题](../theme/default-theme-config.md)。
 
+## Pluggable
+
+### plugins
+
+- Type: `Object|Array`
+- Default: `undefined`
+
+请参考 [plugin API > Using a plugin](../plugin/README.md#using-a-plugin) 来使用一个插件。
+
 ## Markdown
 
 ### markdown.lineNumbers

packages/docs/docs/zh/plugin/official.md

@@ -6,37 +6,37 @@ sidebar: auto
 
 ## @vuepress/search
 
-### Options
+- TODO
 
 ## @vuepress/pwa
 
-### Options
+- TODO
 
 ## @vuepress/blog
 
-### Options
+- TODO
 
 ## @vuepress/pagination
 
-### Options
+- TODO
 
 ## @vuepress/google-analytics
 
-### Options
+- TODO
 
 ## @vuepress/i18n-ui
 
-### Options
+- TODO
 
 ## @vuepress/last-updated
 
-### Options
+- TODO
 
 ## @vuepress/medium-zoom
 
-### Options
+- TODO
 
 ## @vuepress/back-to-top
 
-### Options
+- TODO