From 3dc43c200c8b8bac2f1199e27b73d898658c87de Mon Sep 17 00:00:00 2001
From: Rafael Gaspar <rafael.gaspar@wooga.net>
Date: Mon, 19 Sep 2022 14:53:13 +0200
Subject: [PATCH] Improve documentation with both single and multi-arch steps

---
 public-docker-images/README.md | 22 +++++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

diff --git a/public-docker-images/README.md b/public-docker-images/README.md
index 73285a00d..be6665655 100644
--- a/public-docker-images/README.md
+++ b/public-docker-images/README.md
@@ -9,16 +9,32 @@ You should run these commands from the project root.
 For the Debian-based image:
 
 ```
-docker buildx build --platform=linux/amd64,linux/arm64 --build-arg=VERSION=$(git rev-parse HEAD) --no-cache -t veneur:local -f public-docker-images/Dockerfile-debian-sid --output=tar . | docker import -
+docker build --build-arg=VERSION=$(git rev-parse HEAD) --no-cache -t veneur:local -f public-docker-images/Dockerfile-debian-sid .
 ```
 
 For the Alpine Linux-based image:
 
 ```
-docker buildx build --platform=linux/amd64,linux/arm64 --build-arg=VERSION=$(git rev-parse HEAD) --no-cache -t veneur:local -f public-docker-images/Dockerfile-alpine --output=tar . | docker import -
+docker build --build-arg=VERSION=$(git rev-parse HEAD) --no-cache -t veneur:local -f public-docker-images/Dockerfile-alpine .
 ```
 
-For both cases you could remove ```--platform` arugment if you just plan build for the host architechture.
+## Building with multi-arch
+
+You should run these commands from the project root.
+
+For the Debian-based image:
+
+```
+docker buildx build --platform=linux/amd64,linux/arm64 --build-arg=VERSION=$(git rev-parse HEAD) --no-cache -t veneur:local -f public-docker-images/Dockerfile-debian-sid --output=type=docker
+```
+
+For the Alpine Linux-based image:
+
+```
+docker buildx build --platform=linux/amd64,linux/arm64 --build-arg=VERSION=$(git rev-parse HEAD) --no-cache -t veneur:local -f public-docker-images/Dockerfile-alpine --output=type=docker
+```
+
+Multi-arch build works best when pushing to a remote repository, so tag it accordingly and replace `--output=type=docker` with `--push` for that to work.
 
 ## Running