From 8c9151571259f013ffdc284f203f58ff01e40e8b Mon Sep 17 00:00:00 2001
From: Faustin Lammler <faustin@fala.red>
Date: Fri, 29 May 2020 18:20:47 +0200
Subject: [PATCH] Improve documentation

It was not clear which variable was necessary on which node of the
master/replica cluster.
---
 README.md | 23 ++++++++++++++++++-----
 1 file changed, 18 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 0be2b85..983ffa7 100644
--- a/README.md
+++ b/README.md
@@ -188,17 +188,30 @@ module (see
 [`tasks/replication_replica.yml`](./tasks/replication_replica.yml#L09-L33) and
 <https://github.com/ansible/ansible/pull/62648>).
 
+#### Common vars
+
 ```yaml
-mariadb_replication_role: "" # master|replica
-mariadb_replication_master_ip: ""
+# Same keys as `mariadb_users` above.
+# priv is set to "*.*:REPLICATION SLAVE" by default
+mariadb_replication_user: []
+```
+
+#### Master variables
+
+```yaml
+mariadb_replication_role: "master"
 mariadb_server_id: "1"
 mariadb_max_binlog_size: "100M"
 mariadb_binlog_format: "MIXED"
 mariadb_expire_logs_days: "10"
+```
 
-# Same keys as `mariadb_users` above.
-# priv is set to "*.*:REPLICATION SLAVE" by default
-mariadb_replication_user: []
+#### Replica variables
+
+```yaml
+mariadb_replication_role: "replica"
+mariadb_server_id: "1"
+mariadb_replication_master_ip: "IP"
 ```
 
 ### Backups (optional)