Document deploy --watch

doc/user-guide/cli.md

@@ -32,7 +32,12 @@ Once the command exits, you can deploy:
 ploomber-cloud deploy
 ```
 
-The `deploy` command will print a URL that you can visit to track deployment progress.
+The `deploy` command will print a URL that you can visit to track deployment progress. If you would like to track progress in the command line,
+add the `--watch` flag.
+
+```sh
+ploomber-cloud deploy --watch
+```
 
 ## Configure an existing project
 
@@ -59,6 +64,4 @@ Then, execute:
 
 ```sh
 ploomber-cloud deploy
-```
-
-The `deploy` command will print a URL that you can visit to track deployment progress.
+```

doc/user-guide/github.md

@@ -48,8 +48,25 @@ Once you push, you can monitor progress from GitHub. First, go to the actions se
 
 Then, click on the most recent run, and you'll see the logs:
 
-![](../static/github/logs.png)
+![](../static/github/logs-watch.png)
+
+In the logs, you will see updates on the progress of the deployment. You'll also see a URL to your project dashboard where you can check its status.
+Once the deployment has succeeded, it will return a URL to view your deployed project.
+
+If you would prefer to track progress only through the project dashboard, you can remove `--watch` from the `deploy` command in your `ploomber-cloud.yaml`:
+
+```yaml
+ - name: Deploy
+        env:
+          PLOOMBER_CLOUD_KEY: ${{ secrets.PLOOMBER_CLOUD_KEY }}
+        run: |
+          ploomber-cloud deploy # removed '--watch' here
+```
+
+Removing `--watch` means deployment updates won't be output to the logs, but you will still be able to track its progress through the URL.
 
-In the logs, you'll see a URL that you can use to track progress.
+Without `--watch`, the logs will look like this:
+
+![](../static/github/logs.png)
 
 A complete sample project is [available here.](https://github.com/edublancas/cloud-template)