diff --git a/docker_swarm/README.md b/docker_swarm/README.md
index 3be06a4..626195f 100644
--- a/docker_swarm/README.md
+++ b/docker_swarm/README.md
@@ -1,5 +1,9 @@
-# shoarma ansible
+# Docker Swarm
 
-This requires a rootless docker daemon on the Ansible host.
-See: https://docs.docker.com/engine/security/rootless/
-Also you need jsondiff for docker stack.
+On each of our machines, we deploy a virtual machine that participates in a Docker Swarm.
+However, only one VM is a manager (`maestro`) while two are workers (`bancomart` and `vpay`).
+This lack of redundancy in the cluster is deliberate: in case all nodes are down (e.g. misconfiguration or power outage) manual action would need to be taken in order to restore the cluster.
+In case of only one manager node, the cluster is always able to restore itself automatically.
+
+While the operating system of the VMs is managed by NixOS, cluster creation and the deployment of workloads is done through Ansible.
+In my opinion, Ansible is a perfect fit for environments that tend to change a lot (such as a container cluster).
\ No newline at end of file