From 7adea254edcc05c52748e5d02baf55b15414a3af Mon Sep 17 00:00:00 2001
From: Luke Murphy <lukewm@riseup.net>
Date: Tue, 2 Mar 2021 07:31:52 +0100
Subject: [PATCH] Use short app names

---
 docs/deploy.md | 27 ++++++++++++++++-----------
 1 file changed, 16 insertions(+), 11 deletions(-)

diff --git a/docs/deploy.md b/docs/deploy.md
index 8aecb650..25ce7e5e 100644
--- a/docs/deploy.md
+++ b/docs/deploy.md
@@ -87,23 +87,25 @@ In order to have your Co-op cloud installation automagically provision SSL certi
 $ abra app new --server example.com --domain traefik.example.com traefik
 ```
 
+We can then choose `traefik` as the app name.
+
 You will want to take a look at your generated configuration and tweak the `LETS_ENCRYPT_EMAIL` value:
 
 ```bash
-$ abra app traefik.example.com config
+$ abra app traefik config
 ```
 
 This is the required environment variables that you can configure and are injected into the app configuration when deployed.
 
 ```
-$ abra app traefik.example.com deploy
+$ abra app traefik deploy
 ```
 
 We can then check that everything came up as expected.
 
 ```bash
-$ abra app traefik.example.com ps   # status check
-$ abra app traefik.example.com logs # logs watch
+$ abra app traefik ps   # status check
+$ abra app traefik logs # logs watch
 ```
 
 ## Deploy Nextcloud
@@ -116,10 +118,12 @@ Let's create a new Nextcloud app.
 $ abra app new --server example.com --domain cloud.example.com nextcloud
 ```
 
+We can then choose `nextcloud` as the app name.
+
 And we need to generate secrets for the app: database connection password, root password and admin password.
 
 ```bash
-$ abra app cloud.example.com secret generate --all
+$ abra app nextcloud secret generate --all
 ```
 
 !!! warning
@@ -132,24 +136,25 @@ $ abra app cloud.example.com secret generate --all
 Then we can deploy the Nextcloud.
 
 ```bash
-$ abra app cloud.example.com deploy
+$ abra app nextcloud deploy
 ```
 
 And once again, we can watch to see that things come up correctly.
 
 ```bash
-$ abra app nextcloud.example.com ps   # status check
-$ abra app nextcloud.example.com logs # logs watch
+$ abra app nextcloud ps   # status check
+$ abra app nextcloud logs # logs watch
 ```
 
 !!! note
 
-    Since Nextcloud takes some time to come up live, you can run the `ps` command under `watch` like so.
+    Since Nextcloud takes some time to come up live, you can run the `ps`
+    command under `watch` like so.
 
     ```bash
-    $ watch abra app nextcloud.example.com ps
+    $ watch abra app nextcloud ps
     ```
 
     And you can wait until you see that all containers have the "Running" state.
 
-Your Traefik instance should now detect that a new app is coming up and generate SSL certificates for it.
+Your `traefik` instance will detect that a new app is coming up and generate SSL certificates for it.