docs: update Now deployment guide (#4395)

Author: kidonng

docs/guide/deployment.md

@@ -267,71 +267,75 @@ Please refer to the [Firebase Documentation](https://firebase.google.com/docs/ho
 
 This example uses the latest Now platform version 2.
 
-1. Install the Now CLI globally:
+1. Install the Now CLI:
 
 ```bash
 npm install -g now
+
+# Or, if you prefer a local one
+npm install now
 ```
 
 2. Add a `now.json` file to your project root:
 
     ```json
-    {
-      "name": "my-example-app",
-      "version": 2,
-      "builds": [
-        { "src": "dist/**", "use": "@now/static" }
-      ],
-      "routes": [
-        { "src": "/(.*)", "dest": "dist/$1" }
-      ],
-      "alias": "vue-example"
-    }
-    ```
-    
-   In case you want to deploy an application with router mode set to history, the config file should look like the following (if you have different folder names, update your config accordingly):
-   ```json
     {
       "name": "my-example-app",
       "version": 2,
       "builds": [
         {
-          "src": "dist/**",
-          "use": "@now/static"
+          "src": "package.json",
+          "use": "@now/static-build"
         }
       ],
       "routes": [
         {
-          "src": "/(js|css|img)/(.*)",
-          "dest": "/dist/$1/$2"
-        },
-        {
-          "src": "/favicon.ico",
-          "dest": "/dist/favicon.ico"
+          "src": "/(js|css|img)/.*",
+          "headers": { "cache-control": "max-age=31536000, immutable" }
         },
-        {
-          "src": "/(.*)",
-          "dest": "/dist"
-        }
+        { "handle": "filesystem" },
+        { "src": ".*", "dest": "/" }
       ],
-      "alias": "vue-example"
+      "alias": "example.com"
     }
-   ```
-   This additional config is required in order to avoid issues when directly deep-linking to a specific page (e.g. when opening `my-example-app.now.sh/some-subpage`, you would be presented with a 404 error otherwise).
+    ```
 
-3. Adding a deployment script in `package.json`:
+    If you have different/additional folders, modify the route accordingly:
+
+    ```diff
+    - {
+    -   "src": "/(js|css|img)/.*",
+    -   "headers": { "cache-control": "max-age=31536000, immutable" }
+    - }
+    + {
+    +   "src": "/(js|css|img|fonts|media)/.*",
+    +   "headers": { "cache-control": "max-age=31536000, immutable" }
+    + }
+    ```
 
-    ```json
-    "deploy": "npm run build && now --target production"
+    If your `outputDir` is not the default `dist`, say `build`:
+
+    ```diff
+    - {
+    -   "src": "package.json",
+    -   "use": "@now/static-build"
+    - }
+    + {
+    +   "src": "package.json",
+    +   "use": "@now/static-build",
+    +   "config": { "distDir": "build" }
+    + }
     ```
 
-    If you want to deploy publicly by default, you can change the deployment script to the following one:
+3. Adding a `now-build` script in `package.json`:
 
     ```json
-    "deploy": "npm run build && now --target production --public"
+    "now-build": "npm run build"
     ```
+    
+    To make a deployment, run `now`.
 
-    This will automatically point your site's alias to the latest deployment. Now, just run `npm run deploy` to deploy your app.
+    If you want your deployment aliased, run `now --target production` instead.
 
 ### Stdlib