diff --git a/docs/UPDATING.md b/docs/UPDATING.md
index dce13bb..0436036 100644
--- a/docs/UPDATING.md
+++ b/docs/UPDATING.md
@@ -2,9 +2,9 @@
 
 ## Chevereto
 
-To update to a new Chevereto version re-build the container image (see [BUILDING](BUILDING.md)) to reflect the target version.
+To update instances to a new Chevereto version re-build the container image (see [BUILDING](BUILDING.md)) to reflect the target version.
 
-### One-click updating
+### One-click Chevereto updating
 
 Run the following command to update all instances. The process will swap every instance to the new container image and perform the necessary database updates.
 
@@ -12,7 +12,7 @@ Run the following command to update all instances. The process will swap every i
 ./update.sh
 ```
 
-### Manual updating
+### Manual Chevereto updating
 
 Swap to the new container image by down plus up-d by passing the `NAMESPACE` of your project. Once done, execute the `app/bin/legacy -C update` command to perform the necessary database updates.
 
@@ -22,17 +22,17 @@ make up-d NAMESPACE=yourproject
 make exec NAMESPACE=yourproject COMMAND="app/bin/legacy -C update"
 ```
 
-## Repository update
+## Repository
 
-To update your containers to the latest version of this repository make sure to run first:
+To update your containers to the latest version of this repository make sure to run for every instance:
 
 ```sh
-make down
+make down NAMESPACE=yourproject
 ```
 
 💡 If you forget to run this you can rollback the repo and execute the above command.
 
-### Manual updating
+### Manual repo updating
 
 Pull this updated repo changes in your fork.
 
@@ -40,7 +40,7 @@ Pull this updated repo changes in your fork.
 git fetch --tags -f && git pull
 ```
 
-### GitHub one-click updating
+### GitHub one-click repo updating
 
 1. Go to **Actions**
 2. Select **Update** under **Workflows**