diff --git a/lib/ansible/modules/cloud/azure/azure_rm_hdinsightcluster.py b/lib/ansible/modules/cloud/azure/azure_rm_hdinsightcluster.py
index 0e1550cb492..831b7860b47 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 a5f9928ce0f..80e3fe1407f 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: {}