diff --git a/stages/org.osbuild.mkdir b/stages/org.osbuild.mkdir
index c529750a..bd234948 100755
--- a/stages/org.osbuild.mkdir
+++ b/stages/org.osbuild.mkdir
@@ -3,7 +3,14 @@
 Create directories within the tree.
 
 Can create one or more directories, optionally also the
-intermediate directories.
+intermediate directories. The stage can gracefully handle
+directories that already exist.
+
+Please note that the stage won't change the mode of existing
+directories. If you want to change the mode of an existing
+directory, you need to use the `org.osbuild.chmod` stage.
+Mode is applied only to newly created directories and umask
+value is taken into account.
 """
 
 import os