docs: add miscellaneous part

Author: ulivz

packages/docs/docs/.vuepress/nav/en.js

@@ -24,6 +24,10 @@ module.exports = [
           {
             text: 'Options',
             link: '/plugin/#options'
+          },
+          {
+            text: 'Official Plugins',
+            link: '/plugin/official.html'
           }
         ]
       },
@@ -32,15 +36,15 @@ module.exports = [
         items: [
           {
             text: 'Write a theme',
-            link: '/theme/#writing-a-plugin'
+            link: '/theme/#writing-a-theme'
           },
           {
             text: 'Using a theme',
-            link: '/theme/#using-a-plugin'
+            link: '/theme/#using-a-theme'
           },
           {
             text: 'Options',
-            link: '/theme/api.html'
+            link: '/theme/#options'
           },
           {
             text: 'Default Theme Config',
@@ -49,46 +53,18 @@ module.exports = [
         ]
       },
       {
-        text: 'Official Plugins',
+        text: 'Miscellaneous',
         items: [
           {
-            text: 'search',
-            link: '/plugin/official.html#vuepress-search'
+            text: 'Design Concepts',
+            link: '/miscellaneous/design-concepts.html'
           },
           {
-            text: 'pwa',
-            link: '/plugin/official.html#vuepress-pwa'
-          },
-          {
-            text: 'blog',
-            link: '/plugin/official.html#vuepress-blog'
-          },
-          {
-            text: 'pagination',
-            link: '/plugin/official.html#vuepress-pagination'
-          },
-          {
-            text: 'google-analytics',
-            link: '/plugin/official.html#vuepress-google-analytics'
-          },
-          {
-            text: 'i18n-ui',
-            link: '/plugin/official.html#vuepress-i18n-ui'
-          },
-          {
-            text: 'last-updated',
-            link: '/plugin/official.html#vuepress-last-updated'
-          },
-          {
-            text: 'medium-zoom',
-            link: '/plugin/official.html#vuepress-medium-zoom'
-          },
-          {
-            text: 'back-to-top',
-            link: '/plugin/official.html#vuepress-back-to-top'
+            text: 'Migrate from 0.x.x',
+            link: '/miscellaneous/migration-guide.html'
           }
         ]
-      }
+      },
     ],
   },
   {

packages/docs/docs/.vuepress/nav/zh.js

@@ -24,6 +24,10 @@ module.exports = [
           {
             text: '插件的选项',
             link: '/zh/plugin/#options'
+          },
+          {
+            text: '官方插件',
+            link: '/plugin/official.html'
           }
         ]
       },
@@ -32,11 +36,11 @@ module.exports = [
         items: [
           {
             text: '主题的开发',
-            link: '/zh/theme/#writing-a-plugin'
+            link: '/zh/theme/#writing-a-theme'
           },
           {
             text: '主题的使用',
-            link: '/zh/theme/#using-a-plugin'
+            link: '/zh/theme/#using-a-theme'
           },
           {
             text: '主题的选项',
@@ -49,46 +53,18 @@ module.exports = [
         ]
       },
       {
-        text: '官方插件',
+        text: '了解更多',
         items: [
           {
-            text: 'search',
-            link: '/zh/plugin/official.html#vuepress-search'
+            text: '设计理念',
+            link: '/miscellaneous/design-concepts.html'
           },
           {
-            text: 'pwa',
-            link: '/zh/plugin/official.html#vuepress-pwa'
-          },
-          {
-            text: 'blog',
-            link: '/zh/plugin/official.html#vuepress-blog'
-          },
-          {
-            text: 'pagination',
-            link: '/zh/plugin/official.html#vuepress-pagination'
-          },
-          {
-            text: 'google-analytics',
-            link: '/zh/plugin/official.html#vuepress-google-analytics'
-          },
-          {
-            text: 'i18n-ui',
-            link: '/zh/plugin/official.html#vuepress-i18n-ui'
-          },
-          {
-            text: 'last-updated',
-            link: '/zh/plugin/official.html#vuepress-last-updated'
-          },
-          {
-            text: 'medium-zoom',
-            link: '/zh/plugin/official.html#vuepress-medium-zoom'
-          },
-          {
-            text: 'back-to-top',
-            link: '/zh/plugin/official.html#vuepress-back-to-top'
+            text: '从 0.x.x 迁移',
+            link: '/miscellaneous/migration-guide.html'
           }
         ]
-      }
+      },
     ],
   },
   {

packages/docs/docs/config/README.md

@@ -120,64 +120,18 @@ A function to control what files should have `<link rel="preload">` resource hin
 
 ## Styling
 
-### palette
+### palette.styl
 
-- Type: `Object|String`
-- Default: `undefined`
-
-Set globally available stylus color variables.
-
-If it is string, it needs to be a **absolute path** pointing to a stylus file that defines the color constant:
-
-```js
-module.exports = {
-  palette: path.resolve(__dirname, 'palette.styl'),
-}
-```
-
-::: tip
-When `config.palette` is empty, vuepress will detect whether `.vuepress/palette.styl` exists. If it exists, the file will be used as palette.
-:::
-
-If it is an object, it needs to be an object with key as the color name and value as the color value.
-
-```js
-module.exports = {
-  palette: {
-    // Internal default color constants can be 
-    // modified to quickly modify global styles.
-    $accentColor: '#3eaf7c',
-    $textColor: '#2c3e50',
-    $borderColor: '#eaecef',
-    $codeBgColor: '#282c34',
-    $arrowBgColor: '#ccc',
-
-    // Your extra colors
-    $shadowColor: '#ddd'
-  }
-}
-```
+Create a `.vuepress/style/palette.styl` file and it will be registered as global palette.
 
-::: tip
-It is worth noting that `modifying global style` via `palette` depends on the strict use of the default palette for your theme (e.g. the `@vuepress/theme-default` you see now). 
-:::
-
-### style
-
-- Type: `string`
-- Default: `undefined`
+### index.styl
 
-Extra style file.
+Create a `.vuepress/style/index.styl` file and it will be applied as global styles.
 
-```js
-module.exports = {
-  style: path.resolve(__dirname, 'style.styl'),
-}
-```
+**Also see:**
 
-::: tip
-When `config.style` is empty, vuepress will detect whether `.vuepress/style.styl` exists. If it exists, the file will be applied automatically.
-:::
+- [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)
 
 ## Theming
 

packages/docs/docs/miscellaneous/design-concepts.md

@@ -0,0 +1,10 @@
+---
+sidebar: auto
+---
+
+# Design Concepts of VuePress 1.0
+
+- TODO
+
+
+

packages/docs/docs/miscellaneous/migration-guide.md

@@ -0,0 +1,7 @@
+---
+sidebar: auto
+---
+
+# Migration from 0.x.x
+
+- TODO

packages/docs/docs/plugin/official.md

@@ -2,6 +2,8 @@
 sidebar: auto
 ---
 
+- TODO
+
 # Official Plugins
 
 ## @vuepress/search

packages/docs/docs/theme/README.md

@@ -247,106 +247,3 @@ See: [Config > plugins](../config/README.md#plugins).
 - Default: undefined
 
 See: [Config > palette](../config/README.md#palette).
-
-## Design Concepts
-
-Senior users have found that both theme developers and regular users have the ability to customize global `palettes`, `styles`, `templates` and `plugins`, so how do they work together?
-
-### Loading Priority
-
-For `templates/*`, follow the certain loading priority. Taking `templates/ssr.html` as an example:
-
-@flowstart
-cond1=>condition: User's ssr.html
-exists?
-cond2=>condition: Theme's ssr.html
-exists?
-stage1=>operation: Using user's ssr.html
-stage2=>operation: Using theme's ssr.html
-stage3=>operation: Using default ssr.html
-
-cond1(no, right)->cond2(no)->stage3
-cond1(yes, bottom)->stage1
-cond2(yes, bottom)->stage2
-@flowend
-
-::: warning Note
-When customizing `templates/ssr.html`, or `templates/dev.html`, it is best to modify it on the basis of the [default template files](https://github.com/vuejs/vuepress/blob/master/packages/%40vuepress/core/lib/app/index.dev.html), otherwise it may cause a build failure.
-:::
-
-### Overriding
-
-For `palette.styl`, `index.styl` and `plugins`, follow the principles of overriding:
-
-#### palette.styl
-
-User's `styles/palette.styl` has a higher priority than the theme's `styles/palette.styl`, so the theme can define its own palette and the user can tweak it. e.g.
-
-```stylus
-// theme/styles/palette.styl
-$accentColor = #0f0
-```
-
-```stylus
-// .vuepress/styles/palette.styl
-$accentColor = #f00
-```
-
-So the final value of `$accentColor` is `#f00`.
-
-#### index.styl
-
-Both the user's `styles/index.styl` and the theme's `styles/index.styl` are generated into the final `CSS` file, but the user's style is generated later and therefore has higher priority. e.g.
-
-```stylus
-// theme/styles/index.styl
-.content
-  font-size 14px
-```
-
-```stylus
-// .vuepress/styles/index.styl
-.content
-  font-size 15px
-```
-
-The final generated CSS is as follows:
-
-```css
-/* theme/styles/index.styl */
-.content {
-  font-size: 14px;
-}
-
-/* theme/styles/index.styl */
-.content {
-  font-size: 15px;
-}
-```
-
-#### plugins
-
-Since all plugins with the same name can be applied ONLY once by default, users can override the default options for plugins in theme. e.g.
-
-```js
-// theme/index.js
-module.exports = {
-  plugins: [
-    '@vuepress/i18n-ui',
-    { route: '/i18n-page/' }
-  ] 
-}
-```
-
-```js
-// .vuepress/config.js
-module.exports = {
-  plugins: [
-    '@vuepress/i18n-ui',
-    { route: '/i18n/' }
-  ] 
-}
-```
-
-Then the final route of i18n UI is `/i18n-ui/`.
-