From 913aebb140f9eff55d8217aba4fb96d6c192cc69 Mon Sep 17 00:00:00 2001
From: Andrew Klychkov <aaklychkov@mail.ru>
Date: Fri, 13 Nov 2020 23:51:37 +0300
Subject: [PATCH] Docsite: update user_guide/playbooks_module_defaults (#72051)
 (#72493)

* Docsite: update user_guide/playbooks_module_defaults, add name: lines and use FQCN consistently
(cherry picked from commit dbe43e071ec936b0259f588a5317b35c23ddb7db)
---
 .../user_guide/playbooks_module_defaults.rst  | 52 ++++++++++++-------
 1 file changed, 34 insertions(+), 18 deletions(-)

diff --git a/docs/docsite/rst/user_guide/playbooks_module_defaults.rst b/docs/docsite/rst/user_guide/playbooks_module_defaults.rst
index b217c624165..f1260e22651 100644
--- a/docs/docsite/rst/user_guide/playbooks_module_defaults.rst
+++ b/docs/docsite/rst/user_guide/playbooks_module_defaults.rst
@@ -9,33 +9,40 @@ Here is a basic example::
 
     - hosts: localhost
       module_defaults:
-        file:
+        ansible.builtin.file:
           owner: root
           group: root
           mode: 0755
       tasks:
-        - file:
+        - name: Create file1
+          ansible.builtin.file:
             state: touch
             path: /tmp/file1
-        - file:
+
+        - name: Create file2
+          ansible.builtin.file:
             state: touch
             path: /tmp/file2
-        - file:
+
+        - name: Create file3
+          ansible.builtin.file:
             state: touch
             path: /tmp/file3
 
 The ``module_defaults`` attribute can be used at the play, block, and task level. Any module arguments explicitly specified in a task will override any established default for that module argument::
 
     - block:
-        - debug:
-            msg: "a different message"
+        - name: Print a message
+          ansible.builtin.debug:
+            msg: "Different message"
       module_defaults:
-        debug:
-          msg: "a default message"
+        ansible.builtin.debug:
+          msg: "Default message"
 
 You can remove any previously established defaults for a module by specifying an empty dict::
 
-    - file:
+    - name: Create file1
+      ansible.builtin.file:
         state: touch
         path: /tmp/file1
       module_defaults:
@@ -50,16 +57,21 @@ Interacting with an API that requires auth::
 
     - hosts: localhost
       module_defaults:
-        uri:
+        ansible.builtin.uri:
           force_basic_auth: true
           user: some_user
           password: some_password
       tasks:
-        - uri:
+        - name: Interact with a web service
+          ansible.builtin.uri:
             url: http://some.api.host/v1/whatever1
-        - uri:
+
+        - name: Interact with a web service
+          ansible.builtin.uri:
             url: http://some.api.host/v1/whatever2
-        - uri:
+
+        - name: Interact with a web service
+          ansible.builtin.uri:
             url: http://some.api.host/v1/whatever3
 
 Setting a default AWS region for specific EC2-related modules::
@@ -68,11 +80,11 @@ Setting a default AWS region for specific EC2-related modules::
       vars:
         my_region: us-west-2
       module_defaults:
-        ec2:
+        amazon.aws.ec2:
           region: '{{ my_region }}'
-        ec2_instance_info:
+        community.aws.ec2_instance_info:
           region: '{{ my_region }}'
-        ec2_vpc_net_info:
+        amazon.aws.ec2_vpc_net_info:
           region: '{{ my_region }}'
 
 .. _module_defaults_groups:
@@ -120,8 +132,12 @@ In a playbook, you can set module defaults for whole groups of modules, such as
         group/aws:
           region: us-west-2
       tasks:
-      - aws_s3_bucket_info:
+      - name: Get info
+        aws_s3_bucket_info:
+
       # now the region is shared between both info modules
-      - ec2_ami_info:
+
+      - name: Get info
+        ec2_ami_info:
           filters:
             name: 'RHEL*7.5*'