Document ploomber-cloud examples

doc/apps/voila.md

@@ -1,17 +1,26 @@
 # Voilà
 
-```{tip}
-If you haven't deployed your first application, check out the [quickstart guide.](../quickstart/app.md)
+## Deploy an example
+
+To download and deploy an example Voila application simply run:
+
+```sh
+pip install ploomber-cloud
+ploomber-cloud key YOUR-KEY
+ploomber-cloud examples voila/chat-with-csv
+cd basic-app
+ploomber-cloud init
+ploomber-cloud deploy --watch
 ```
 
+## Deploy your own app
+
 To deploy a application you need two files:
 
 1. A Jupyter notebook file (`.ipynb`)
 2. A dependencies file (`requirements.txt`)
 
-## Voilà
-
-Currently, Ploomber Cloud supports `Voilà` for deploying Jupyter notebooks as applications. For information on how to write Voilà applications, [please check the documentation](https://voila.readthedocs.io/en/stable/).
+For information on how to write Voilà applications, [please check the documentation](https://voila.readthedocs.io/en/stable/).
 
 Click here to see [some examples.](../examples/voila.md)
 

doc/user-guide/cli.md

@@ -67,6 +67,33 @@ Then, execute:
 ploomber-cloud deploy
 ```
 
+## Deploying an example
+
+Ploomber Cloud hosts example applications for many different frameworks. To download and deploy one, run `ploomber-cloud examples`:
+
+```sh
+ploomber-cloud examples
+```
+
+Follow the prompts to choose a framework and specific example name. You may also specify a directory in which to download the example.
+
+Once the application is downloaded, it's ready to deploy! For example, if you downloaded the `basic-app` example for `Flask` in the current directory:
+
+```sh
+ploomber-cloud key YOUR-KEY
+cd basic-app
+ploomber-cloud init
+ploomber-cloud deploy --watch
+```
+
+If you already know which example you want, you can download it while avoiding prompts with `ploomber-cloud examples framework/example-name`:
+
+```sh
+ploomber-cloud examples flask/basic-app
+```
+
+A full list of example applications is available [here](https://github.com/bryannho/doc/tree/main/examples)
+
 ## Defining environment variables
 
 If your project uses environment variables, you can define them in an `.env` file.