docs: suggest to use yarn (#1968)

Author: Sun Haoran

packages/docs/docs/guide/deploy.md

@@ -66,7 +66,7 @@ You can also run the above script in your CI setup to enable automatic deploymen
 
 2. Create a file named `.travis.yml` in the root of your project.
 
-3. Run `npm install` locally and commit `package-lock.json` as it’s required for `npm ci`.
+3. Run `yarn` or `npm install` locally and commit the generated lockfile (i.e. `yarn.lock` or `package-lock.json`).
 
 4. Use GitHub Pages deploy provider template and follow the [travis documentation](https://docs.travis-ci.com/user/deployment/pages/).
 
@@ -75,9 +75,9 @@ language: node_js
 node_js:
   - lts/*
 install:
-  - npm ci
+  - yarn install # npm ci
 script:
-  - npm run docs:build
+  - yarn docs:build # npm run docs:build
 deploy:
   provider: pages
   skip_cleanup: true
@@ -109,8 +109,8 @@ pages:
     - node_modules/
 
   script:
-  - npm install
-  - npm run docs:build
+  - yarn install # npm install
+  - yarn docs:build # npm run docs:build
   artifacts:
     paths:
     - public
@@ -123,7 +123,7 @@ pages:
 
 1. On [Netlify](https://netlify.com), setup up a new project from GitHub with the following settings:
 
-- **Build Command:** `npm run docs:build` or `yarn docs:build`
+- **Build Command:** `yarn docs:build` or `npm run docs:build`
 - **Publish directory:** `docs/.vuepress/dist`
 
 2. Hit the deploy button!

packages/docs/docs/plugin/official/plugin-google-analytics.md

@@ -15,6 +15,10 @@ yarn add -D @vuepress/plugin-google-analytics
 # OR npm install -D @vuepress/plugin-google-analytics
 ```
 
+::: warning
+We currently recommend using [Yarn](https://yarnpkg.com/en/) instead of npm to install all dependencies if you are using Google Analytics Plugin, because npm fails to generate the correct dependency tree in this case.
+:::
+
 ## Usage
 
 ```javascript

packages/docs/docs/zh/guide/deploy.md

@@ -65,17 +65,17 @@ cd -
    如果你打算发布到 `https://<USERNAME or GROUP>.github.io/<REPO>/`（也就是说你的仓库在 `https://github.com/<USERNAME>/<REPO>`），则将 `base` 设置为 `"/<REPO>/"`。
 
 2. 在项目的根目录创建一个名为 `.travis.yml` 的文件；
-3. 在本地执行 `npm install` 并且在提交中包含 `package-lock.json` 因为 `npm ci` 需要它才能正确执行.
+3. 在本地执行 `yarn` 或 `npm install` 并且提交生成的 lock 文件（即 `yarn.lock` 或 `package-lock.json`）；
 4. 使用 GitHub Pages 部署提供程序模板并遵循 [Travis 文档](https://docs.travis-ci.com/user/deployment/pages/)。
 
 ``` yaml
 language: node_js
 node_js:
   - lts/*
 install:
-  - npm ci
+  - yarn install # npm ci
 script:
-  - npm run docs:build
+  - yarn docs:build # npm run docs:build
 deploy:
   provider: pages
   skip_cleanup: true
@@ -106,8 +106,8 @@ pages:
    - node_modules/
 
  script:
- - npm install
- - npm run docs:build
+ - yarn install # npm install
+ - yarn docs:build # npm run docs:build
  artifacts:
    paths:
    - public
@@ -119,7 +119,7 @@ pages:
 
 1. 在 Netlify 中, 创建一个新的 GitHub 项目，使用以下设置：
 
-- **Build Command:** `npm run build:docs` 或者 `yarn build:docs`
+- **Build Command:** `yarn build:docs` 或者 `npm run build:docs`
 - **Publish directory:** `docs/.vuepress/dist`
 
 2. 点击 deploy 按钮！

packages/docs/docs/zh/plugin/official/plugin-google-analytics.md

@@ -14,6 +14,10 @@ yarn add -D @vuepress/plugin-google-analytics
 # OR npm install -D @vuepress/plugin-google-analytics
 ```
 
+::: warning
+如果你的项目正在使用 Google analytics 插件，推荐使用 [Yarn](https://yarnpkg.com/en/) 而不是 npm 来安装所有依赖。因为在这种情形下，npm 会生成错误的依赖树。
+:::
+
 ## 使用
 
 ```javascript