From 3ef09496a3f756c14d45b416dcd81def1b95c25d Mon Sep 17 00:00:00 2001
From: Fred-sun <37327967+Fred-sun@users.noreply.github.com>
Date: Thu, 30 May 2019 11:34:38 -0400
Subject: [PATCH] Update azure_rm_hdinsightcluster related document (#57037)

* Update azure_rm_hdinsightcluster related documentation
---
 .../cloud/azure/azure_rm_hdinsightcluster.py  | 22 +++++++++----------
 .../azure/azure_rm_hdinsightcluster_facts.py  | 13 ++++++-----
 2 files changed, 18 insertions(+), 17 deletions(-)

diff --git a/lib/ansible/modules/cloud/azure/azure_rm_hdinsightcluster.py b/lib/ansible/modules/cloud/azure/azure_rm_hdinsightcluster.py
index 0e1550cb49..831b7860b4 100644
--- a/lib/ansible/modules/cloud/azure/azure_rm_hdinsightcluster.py
+++ b/lib/ansible/modules/cloud/azure/azure_rm_hdinsightcluster.py
@@ -17,7 +17,7 @@ DOCUMENTATION = '''
 ---
 module: azure_rm_hdinsightcluster
 version_added: "2.8"
-short_description: Manage Azure HDInsight Cluster instance.
+short_description: Manage Azure HDInsight Cluster instance
 description:
     - Create, update and delete instance of Azure HDInsight Cluster.
 
@@ -35,7 +35,7 @@ options:
             - Resource location. If not set, location from the resource group will be used as default.
     cluster_version:
         description:
-            - The version of the cluster. For example I(3.6)
+            - The version of the cluster. For example C(3.6).
     os_type:
         description:
             - The type of operating system.
@@ -85,17 +85,17 @@ options:
                     - The instance count of the cluster.
             vm_size:
                 description:
-                    - The size of the VM
+                    - The size of the VM.
             linux_profile:
                 description:
                     - The Linux OS profile.
                 suboptions:
                     username:
                         description:
-                            - User name
+                            - SSH user name.
                     password:
                         description:
-                            - Password
+                            - SSH password.
     storage_accounts:
         description:
             - The list of storage accounts in the cluster.
@@ -103,7 +103,7 @@ options:
         suboptions:
             name:
                 description:
-                    - Blob storage endpoint.
+                    - Blob storage endpoint. For example storage_account_name.blob.core.windows.net.
             is_default:
                 description:
                     - Whether or not the storage account is the default storage account.
@@ -115,19 +115,19 @@ options:
                     - The storage account access key.
     state:
       description:
-        - Assert the state of the cluster.
-        - Use C(present) to create or update a cluster and C(absent) to delete it.
+          - Assert the state of the cluster.
+          - Use C(present) to create or update a cluster and C(absent) to delete it.
       default: present
       choices:
-        - absent
-        - present
+          - absent
+          - present
 
 extends_documentation_fragment:
     - azure
     - azure_tags
 
 author:
-    - "Zim Kalinowski (@zikalino)"
+    - Zim Kalinowski (@zikalino)
 
 '''
 
diff --git a/lib/ansible/modules/cloud/azure/azure_rm_hdinsightcluster_facts.py b/lib/ansible/modules/cloud/azure/azure_rm_hdinsightcluster_facts.py
index a5f9928ce0..80e3fe1407 100644
--- a/lib/ansible/modules/cloud/azure/azure_rm_hdinsightcluster_facts.py
+++ b/lib/ansible/modules/cloud/azure/azure_rm_hdinsightcluster_facts.py
@@ -17,7 +17,7 @@ DOCUMENTATION = '''
 ---
 module: azure_rm_hdinsightcluster_facts
 version_added: "2.8"
-short_description: Get Azure HDInsight Cluster facts.
+short_description: Get Azure HDInsight Cluster facts
 description:
     - Get facts of Azure HDInsight Cluster.
 
@@ -36,7 +36,7 @@ extends_documentation_fragment:
     - azure
 
 author:
-    - "Zim Kalinowski (@zikalino)"
+    - Zim Kalinowski (@zikalino)
 
 '''
 
@@ -53,7 +53,8 @@ EXAMPLES = '''
 
 RETURN = '''
 clusters:
-    description: A list of dictionaries containing facts for HDInsight Cluster.
+    description:
+        - A list of dictionaries containing facts for HDInsight Cluster.
     returned: always
     type: complex
     contains:
@@ -128,7 +129,7 @@ clusters:
                     sample: 2
                 vm_size:
                     description:
-                        - The size of the VM
+                        - The size of the VM.
                     returned: always
                     type: str
                     sample: Standard_D3
@@ -138,7 +139,7 @@ clusters:
                     contains:
                         username:
                             description:
-                                - User name
+                                - User name.
                             returned: always
                             type: str
                             sample: myuser
@@ -173,7 +174,7 @@ clusters:
                     sample: TCP
         tags:
             description:
-                - Tags
+                - The tags of the resource.
             returned: always
             type: complex
             sample: {}