docs: update getting-started

Author: rakannimer

src/docs/documentation/general/getting-started.mdx

@@ -7,37 +7,46 @@ menu: General
 
 # Getting Started
 
-> ⚠️ Since v1 you need `react` and `react-dom` with `>= 16.8.0` installed.
+<!-- > Starting from Docz v1 you need to have `react` and `react-dom` with versions `>= 16.8.0` installed as dependencies. -->
 
-## Migration Guide
 
-This documentation it's about **v2**. If you need to migrate your Docz project, please read our [**Migration Guide**](/docs/migration-guide).
-If you are looking for documentation for v1 it's [**here**](https://docz-v1.surge.sh/)
+## Start a New Project 
+
+Use create-docz-app to quickly get started :
 
-## Installation
+```sh
+npx create-docz-app my-docz-app
+# or
+yarn create docz-app my-docz-app --example typescript
+```
 
-Getting started with **Docz** is something really easy and quick.
-First of all, you will need to install **Docz** using your favorite package manager:
+Make sure to check out [docz's `examples` directory](https://github.com/doczjs/docz/tree/master/examples) for the full list of supported examples.
 
-```bash
-$ yarn add docz@next react react-dom
+## Add Docz to an Existing Project
+
+> Make sure you have `react` and `react-dom` with versions `>= 16.8.0` installed as dependencies.
+
+Start by adding **Docz** as a dependency :
+
+```sh
+yarn add docz@next # react react-dom
 ```
 or
-```bash
-$ npm add docz@next react react-dom
+```sh
+npm add docz@next # react react-dom
 ```
 
-> ### Warnings and tips
-> Don't forget to install **react** and **react-dom**
+After installing Docz in your project, you may find it convenient to add three scripts to your `package.json` to run, build and serve your Docz website.
 
-> After you installed Docz in your project, you may find it convenient to add two scripts in your `package.json` to run Docz for you. This is an **optional step**:
+Note that this is an **optional step** :
 
 ```json
 {
   "name": "next-gen-documentation",
   "scripts": {
     "docz:dev": "docz dev",
-    "docz:build": "docz build"
+    "docz:build": "docz build",
+    "docz:serve": "docz build && docz serve"
   },
   "dependencies": {
     "docz": "latest",
@@ -47,24 +56,26 @@ $ npm add docz@next react react-dom
 }
 ```
 
-Now you can spin up your dev server by running:
+You can now spin up your dev server by running:
 
 ```bash
-$ yarn docz:dev
+yarn docz:dev # or yarn docz dev
 ```
 or
 ```bash
-$ npm run docz:dev
+npm run docz:dev
 ```
 
-## Using
+## Develop
+
+With your dev server up, you can start writing your documentation. 
 
-With your dev server up, you can start writing your documentation. Docz uses [**MDX**](https://mdxjs.com/) as a standard
-format because of the flexibility of writing JSX inside markdown files.
+Docz uses the [**MDX**](https://mdxjs.com/) format that allows you to seamlessly write JSX inside your markdown files.
 
-> Note that you **don't need to follow any strict file architecture**. You can just create your `.mdx` files **anywhere in your project**.
+> Note that you **don't need to follow any file architecture or convention**. 
+> You can just create your `.mdx` files and put them **anywhere in your project**.
 
-So, let's create our first `.mdx` and give it a name and a route:
+With that in mind, let's create our first `.mdx` and give it a name and a route:
 
 ```markdown
 ---
@@ -77,8 +88,37 @@ route: /
 Hello, I'm a mdx file!
 ```
 
-With your first `.mdx` created, you can open your browser and visit `localhost:3000` and you should see something like this:
+With your first `.mdx` document created, you can open your browser and visit `localhost:3000` to see something like this:
 
 ![](https://cdn-std.dprcdn.net/files/acc_649651/Y825GV)
 
-_MDX_ is markdown with extra everything. We cover more on what you can do with _MDX_ under [**Writing MDX**](/docs/writing-mdx)
+We cover more of what you can do with _MDX_ in the [**Writing MDX**](/docs/writing-mdx) page.
+
+## Build 
+
+`yarn docz build` will generate a static site for your site in `.docz/dist/`.
+
+You can try it out with `yarn docz serve` or by serving the generated site with your favorite static file server (e.g. `npx serve .docz/dist`). 
+
+You can have `yarn docz build` emit to a different directory by providing a path to the `dest` field in your doczrc.js or from the command line : `yarn docz build --dest docs-site-directory`. 
+
+## Deploy
+
+The output of docz consists of static assets only. This allows you to deploy your generated `docz` site with any static site hosting provider you'd like. 
+
+Start by building your site with `yarn docz build`, if you haven't provided a `dest` flag to your config then you will find your generated files in `.docz/dist` that you can copy to your server to deploy your site.
+
+## Examples
+
+You can check the complete list of docz examples [here](https://github.com/doczjs/docz/tree/master/examples).
+
+
+## Migration Guide
+
+This documentation is about **Docz v2**.
+
+If you need to migrate your Docz project, please read the [**Migration Guide**](/docs/migration-guide).
+
+If you are looking for documentation for v1 you can find it [**here**](https://docz-v1.surge.sh/).
+
+