From 7b14a642b6a3e2313f6ea3ce26cbc0576760bf6d Mon Sep 17 00:00:00 2001
From: Mikhail Gordeev <obirvalger@altlinux.org>
Date: Thu, 16 Feb 2023 03:16:51 +0300
Subject: [PATCH] Update README.md

---
 README.md | 21 +++++++++++++++++----
 1 file changed, 17 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 24a4daa..9c00f45 100644
--- a/README.md
+++ b/README.md
@@ -1,14 +1,27 @@
-docker-derivatives
-==================
+# docker-derivatives
 
+## alt images
 To build `alt` images, run:
-
 ```
 ./build.py -o alt
 ```
 
+## k8s images
 To build `k8s` images for branch `p10` and push to repository `test_k8s`, run:
-
 ```
 ./build.py -o k8s -b p10 --overwrite-organization test_k8s --tasks tasks.json --tags tags.json
 ```
+
+## distroless-images
+### create
+To create distroless image copy one of existing `org/alt/distroless-*` images.
+Or create directory and copy `distroless-example.toml` to it, rename file to
+`distroless.toml` and edit.
+
+### build
+For example if created image alt/distroless-false and you want to push to
+the organization `<ORGANIZATION>`, run:
+```
+./build.py -i alt/distroless-false --overwrite-organization <ORGANIZATION>
+```
+If you push to the users repository, then organiztion is your username.