From e4092a2eedea2dc34f44e956f1a97fc1f6bebcfc Mon Sep 17 00:00:00 2001
From: f <f@sutty.nl>
Date: Thu, 11 Jul 2024 11:38:09 -0300
Subject: [PATCH 1/3] fix: instruct people to restart their terminals

modifying shell rc files don't have immediate effect and it's confusing
if you don't know this.
---
 docs/abra/cheat-sheet.md   | 2 ++
 docs/operators/tutorial.md | 3 ++-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/docs/abra/cheat-sheet.md b/docs/abra/cheat-sheet.md
index 2a3559a..bd133ba 100644
--- a/docs/abra/cheat-sheet.md
+++ b/docs/abra/cheat-sheet.md
@@ -15,6 +15,8 @@ Definitely set up autocomplete or you'll be sad :sob: `abra` supports `bash`,
 
 ```
 $ abra autocomplete bash
+# Restart your terminal or load autocompletion in place
+$ source /etc/bash_completion.d/abra
 ```
 
 
diff --git a/docs/operators/tutorial.md b/docs/operators/tutorial.md
index d3bc1ae..f414537 100644
--- a/docs/operators/tutorial.md
+++ b/docs/operators/tutorial.md
@@ -82,7 +82,8 @@ abra -h
 ```
 
 You may need to add the `~/.local/bin/` directory to your `$PATH` variable, in
-order to run the executable.
+order to run the executable. Also, run this line into your terminal so
+you have immediate access to `abra` on the current terminal.
 
 ```bash
 export PATH=$PATH:$HOME/.local/bin
-- 
2.47.2


From 58d5e919276a7ec5eaca68051ce782271612f52e Mon Sep 17 00:00:00 2001
From: f <f@sutty.nl>
Date: Thu, 11 Jul 2024 11:39:33 -0300
Subject: [PATCH 2/3] fix: you need to re-login after usermod

---
 docs/operators/tutorial.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/operators/tutorial.md b/docs/operators/tutorial.md
index f414537..c9c190f 100644
--- a/docs/operators/tutorial.md
+++ b/docs/operators/tutorial.md
@@ -38,6 +38,10 @@ wget -O- https://get.docker.com | bash
 # add user to docker group
 sudo usermod -aG docker $USER
 
+# exit and re-login to load the group
+exit
+ssh <server-domain>
+
 # setup swarm
 docker swarm init
 docker network create -d overlay proxy
-- 
2.47.2


From aacdbac9ad6742384c6742ba71fa5bc570a06512 Mon Sep 17 00:00:00 2001
From: f <f@sutty.nl>
Date: Thu, 11 Jul 2024 11:39:48 -0300
Subject: [PATCH 3/3] fix: be specific about when commands are local or remote

---
 docs/operators/tutorial.md | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/docs/operators/tutorial.md b/docs/operators/tutorial.md
index c9c190f..cdb5429 100644
--- a/docs/operators/tutorial.md
+++ b/docs/operators/tutorial.md
@@ -32,6 +32,9 @@ You need to keep port `:80` and `:443` free on your server for web proxying to y
     Docker.
 
 ```
+# ssh into your server
+ssh <server-domain>
+
 # docker install convenience script
 wget -O- https://get.docker.com | bash
 
@@ -42,9 +45,12 @@ sudo usermod -aG docker $USER
 exit
 ssh <server-domain>
 
-# setup swarm
+# back on the server, setup swarm
 docker swarm init
 docker network create -d overlay proxy
+
+# now you can exit and start using abra
+exit
 ```
 
 ??? question "Do you support multiple web proxies?"
-- 
2.47.2