document example with tasks grouped in a block

Co-authored-by: Andrew Klychkov <aaklychkov@mail.ru>

plugins/modules/mysql_info.py

@@ -126,34 +126,37 @@ EXAMPLES = r'''
     exclude_fields: db_size
     return_empty_dbs: true
 
-- name: Clone users on another server - Step 1
+- name: Clone users from one server to another
-  delegate_to: server_source
+  block:
-  community.mysql.mysql_info:
+  # Step 1
-    filter:
+  - name: Fetch information from a source server
-      - users_privs
+    delegate_to: server_source
-  register: result
+    community.mysql.mysql_info:
-
+      filter:
-# Don't work with sha256_password and cache_sha2_password
+        - users_privs
-- name: Clone users on another server - Step 2
+    register: result
-  community.mysql.mysql_user:
-    name: "{{ item.name }}"
-    host: "{{ item.host }}"
-    plugin: "{{ item.plugin | default(omit) }}"
-    plugin_auth_string: "{{ item.plugin_auth_string | default(omit) }}"
-    plugin_hash_string: "{{ item.plugin_hash_string | default(omit) }}"
-    tls_require: "{{ item.tls_require | default(omit) }}"
-    priv: "{{ item.priv | default(omit) }}"
-    resource_limits: "{{ item.resource_limits | default(omit) }}"
-    column_case_sensitive: true
-    state: present
-  loop: "{{ result.users_privs }}"
-  loop_control:
-    label: "{{ item.name }}@{{ item.host }}"
-  when:
-    - item.name != 'root'  # In case you don't want to import admin accounts
-    - item.name != 'mariadb.sys'
-    - item.name != 'mysql'
 
+  # Step 2
+  # Don't work with sha256_password and cache_sha2_password
+  - name: Clone users fetched in a previous task to a target server
+    community.mysql.mysql_user:
+      name: "{{ item.name }}"
+      host: "{{ item.host }}"
+      plugin: "{{ item.plugin | default(omit) }}"
+      plugin_auth_string: "{{ item.plugin_auth_string | default(omit) }}"
+      plugin_hash_string: "{{ item.plugin_hash_string | default(omit) }}"
+      tls_require: "{{ item.tls_require | default(omit) }}"
+      priv: "{{ item.priv | default(omit) }}"
+      resource_limits: "{{ item.resource_limits | default(omit) }}"
+      column_case_sensitive: true
+      state: present
+    loop: "{{ result.users_privs }}"
+    loop_control:
+      label: "{{ item.name }}@{{ item.host }}"
+    when:
+      - item.name != 'root'  # In case you don't want to import admin accounts
+      - item.name != 'mariadb.sys'
+      - item.name != 'mysql'
 '''
 
 RETURN = r'''