docs: Make scaffolding path a first-class citizen for getting started (#2450)

* docs: surface scaffolding tool on home page

* docs: add quick start section to getting started

* style: fix linting error

* docs: fix grammatical errors

Author: bencodezen

packages/docs/docs/README.md

@@ -28,18 +28,20 @@ footer: MIT Licensed | Copyright © 2018-present Evan You
 ### As Easy as 1, 2, 3
 
 ``` bash
-# install
-yarn global add vuepress
-# OR npm install -g vuepress
+# Scaffold VuePress site
+yarn create vuepress [directoryName]
+# OR npx create-vuepress [directoryName]
 
-# create a markdown file
-echo '# Hello VuePress' > README.md
+# Navigate to your new VuePress directory
+cd [directoryName]
 
-# start writing
-vuepress dev
+# Start local dev server
+yarn dev
+# OR npm run dev
 
-# build to static files
-vuepress build
+# Build static files
+yarn build
+# OR npm run build
 ```
 
 ::: warning COMPATIBILITY NOTE

packages/docs/docs/guide/getting-started.md

@@ -4,6 +4,31 @@
 VuePress requires [Node.js](https://nodejs.org/en/) >= 8.6.
 :::
 
+## Quick Start
+
+The fastest way to get your VuePress project setup is to use our create-vuepress tool which will help scaffold the basic VuePress site structure for you.
+
+To use it, open up your terminal in the desired directory and run the following command:
+
+```bash
+yarn create vuepress [directoryName]
+# OR npx create-vuepress [directoryName]
+```
+
+You will be prompted to choose which boilerplate you prefer. For most users, the `docs` boilerplate is what you will want.
+
+You will then have the opportunity to configure your VuePress site’s metadata such as:
+
+- Project Name
+- Description
+- Maintainer Email
+- Maintainer Name
+- Repository URL
+
+Once it is complete, you should see your new VuePress site scaffolded in your directory! :tada:
+
+## Manual Setup
+
 This section will help you build a basic VuePress documentation site from ground up. If you already have an existing project and would like to keep documentation inside the project, start from Step 3.
 
 1. Create and change into a new directory
@@ -20,8 +45,6 @@ This section will help you build a basic VuePress documentation site from ground
 
 3. Install VuePress locally
 
-   Globally installed VuePress is no longer recommended.
-
    ``` bash
    yarn add -D vuepress # npm install -D vuepress
    ```