diff --git a/Makefile b/Makefile
index 64e15ddf8..93febc4b4 100644
--- a/Makefile
+++ b/Makefile
@@ -84,10 +84,14 @@ lint: ## run linter(s)
 
 .PHONY: docs
 docs: ## generate documentation
-	@docker build . \
-	--output type=local,dest=./docs/ \
+	$(eval $@_TMP_OUT := $(shell mktemp -d -t dockercli-output.XXXXXXXXXX))
+	docker build . \
+	--output type=local,dest=$($@_TMP_OUT) \
 	-f ./docs/docs.Dockerfile \
 	--target update
+	rm -rf ./docs/internal
+	cp -R "$($@_TMP_OUT)"/out/* ./docs/
+	rm -rf "$($@_TMP_OUT)"/*
 
 .PHONY: validate-docs
 validate-docs: ## validate the doc does not change
diff --git a/docs/docs.Dockerfile b/docs/docs.Dockerfile
index 780a9736e..3eb163b59 100644
--- a/docs/docs.Dockerfile
+++ b/docs/docs.Dockerfile
@@ -39,7 +39,7 @@ cp -r docs/reference /out
 EOT
 
 FROM scratch AS update
-COPY --from=gen /out /
+COPY --from=gen /out /out
 
 FROM gen AS validate
 RUN --mount=target=/context \