diff --git a/roles/caddy_socket_proxy/README.md b/roles/caddy_socket_proxy/README.md
new file mode 100644
index 0000000..5b674fa
--- /dev/null
+++ b/roles/caddy_socket_proxy/README.md
@@ -0,0 +1 @@
+Sets up a caddy container and a systemd socket unit, forwarding traffic from it to target container
diff --git a/roles/windmill/README.md b/roles/windmill/README.md
new file mode 100644
index 0000000..93b6cbd
--- /dev/null
+++ b/roles/windmill/README.md
@@ -0,0 +1 @@
+Installs windmill with worker in podman in podman