Update "Deploying with Now" Guide (#10390)

* Update the Now guide to use Now v2

* Add reference

* Address review comments

* Update docs/docs/deploying-to-now.md

Co-Authored-By: timothyis <[email protected]>

* Update docs/docs/deploying-to-now.md

Co-Authored-By: timothyis <[email protected]>

* Update docs/docs/deploying-to-now.md

Co-Authored-By: timothyis <[email protected]>

* Update docs/docs/deploying-to-now.md

Co-Authored-By: timothyis <[email protected]>

* Update deploying-to-now.md

Author: timothyis

docs/docs/deploying-to-now.md

@@ -2,36 +2,79 @@
 title: Deploying to Now
 ---
 
-In order to deploy your Gatsby project using [Now](https://zeit.co/now), you can do the following:
+[ZEIT Now](https://zeit.co/now) is a [cloud platform for serverless deployment](https://zeit.co/docs/v2/getting-started/introduction-to-now/) that you can use to deploy your Gatsby projects and [alias them](https://zeit.co/docs/v2/domains-and-aliases/aliasing-a-deployment/) to your personal domain or a free `.now.sh` suffixed URL.
 
-1.  Install the Now CLI
+This guide will show you how to get started in a few quick steps:
 
-`npm install -g now`
+## Step 1: Getting Started with Gatsby
 
-2.  Run `gatsby build` at the root of your project.
+If you haven't already [set up a Gatsby project](https://www.gatsbyjs.org/docs/quick-start) you can do so by first installing Gatsby globally:
 
-3.  Run `now` inside `public/`. This will upload your project to the cloud.
+```shell
+npm install --global gatsby-cli
+```
+
+Then generate a project with the following command:
 
-For large project sizes, it is better to install a Node server package (such as `serve`, or `http-server`):
+```shell
+gatsby new <your project name>
+```
 
-1.  Install a Node server package
+## Step 2: Getting Now
 
-`npm install --save serve`
+You can use Now by installing [Now Desktop](https://zeit.co/docs/v2/getting-started/installation/#now-desktop), which also installs Now CLI and keeps it up-to-date automatically.
 
-2.  Add a `start` script to your `package.json` file. This is what Now will use to run your application:
+To install Now CLI quickly with npm, use the following:
+
+```shell
+npm install -g now
+```
+
+## Step 3: Preparing to Deploy
+
+With Now CLI installed, we can go on to deploy our previously setup Gatsby project by first creating a `now.json` file with the following contents:
+
+```json:title=now.json
+{
+  "version": 2,
+  "name": "my-gatsby-project",
+  "builds": [
+    {
+      "src": "package.json",
+      "use": "@now/static-build",
+      "config": { "distDir": "public" }
+    }
+  ]
+}
+```
+
+This `now.json` file will allow us to do several things, specifically:
+
+- Use the [latest Now 2.0 version](https://zeit.co/blog/now-2) of [the platform](https://zeit.co/docs/v2/platform/overview/)
+- Set the project name to `my-gatsby-project`
+- Use the [@now/static-build builder](https://zeit.co/docs/v2/deployments/official-builders/static-build-now-static-build/) to take the `package.json` file as an entrypoint and use the `public` directory as the our content directory
+
+The final step is to add a script to the `package.json` which will build our application:
 
 ```json:title=package.json
 {
   "scripts": {
-    "start": "serve public/"
+    ...
+    "now-build": "npm run build"
   }
 }
 ```
 
-3.  Run `now` at the root of your Gatsby project, this will upload your project, run the `build` script, and then your `start` script.
+## Step 4: Deploying
 
-To deploy a custom path, run `now` as:
+You can deploy your application by running the following in the root of the project directory, where the `now.json` is:
 
-```shell
-$ now /usr/src/project
+```bash
+now
 ```
+
+That's all! Your application will now deploy, and you will receive a link similar to the following: https://my-gatsby-project-fhcc9hnqc.now.sh/
+
+## References:
+
+- [Deploying Gatsby with Now](https://zeit.co/examples/gatsby/)