diff --git a/lib/ansible/modules/cloud/azure/azure_rm_sqlfirewallrule.py b/lib/ansible/modules/cloud/azure/azure_rm_sqlfirewallrule.py
index e2cd32131d9..f09330a150b 100644
--- a/lib/ansible/modules/cloud/azure/azure_rm_sqlfirewallrule.py
+++ b/lib/ansible/modules/cloud/azure/azure_rm_sqlfirewallrule.py
@@ -17,7 +17,7 @@ DOCUMENTATION = '''
 ---
 module: azure_rm_sqlfirewallrule
 version_added: "2.7"
-short_description: Manage Firewall Rule instance.
+short_description: Manage Firewall Rule instance
 description:
     - Create, update and delete instance of Firewall Rule.
 
@@ -36,24 +36,25 @@ options:
         required: True
     start_ip_address:
         description:
-            - The start IP address of the firewall rule. Must be IPv4 format. Use value C(0.0.0.0) to represent all Azure-internal IP addresses.
+            - The start IP address of the firewall rule.
+            - Must be IPv4 format. Use value C(0.0.0.0) to represent all Azure-internal IP addresses.
     end_ip_address:
         description:
-            - "The end IP address of the firewall rule. Must be IPv4 format. Must be greater than or equal to startIpAddress. Use value C(0.0.0.0) to represe
-               nt all Azure-internal IP addresses."
+            - The end IP address of the firewall rule.
+            - Must be IPv4 format. Must be greater than or equal to I(start_ip_address). Use value C(0.0.0.0) to represent all Azure-internal IP addresses.
     state:
-      description:
-        - Assert the state of the SQL Database. Use C(present) to create or update an SQL Database and C(absent) to delete it.
-      default: present
-      choices:
-        - absent
-        - present
+        description:
+            - State of the SQL Database. Use C(present) to create or update an SQL Database and C(absent) to delete it.
+        default: present
+        choices:
+            - absent
+            - present
 
 extends_documentation_fragment:
     - azure
 
 author:
-    - "Zim Kalinowski (@zikalino)"
+    - Zim Kalinowski (@zikalino)
 
 '''
 
diff --git a/lib/ansible/modules/cloud/azure/azure_rm_sqlfirewallrule_facts.py b/lib/ansible/modules/cloud/azure/azure_rm_sqlfirewallrule_facts.py
index be79e642eab..d669af302e1 100644
--- a/lib/ansible/modules/cloud/azure/azure_rm_sqlfirewallrule_facts.py
+++ b/lib/ansible/modules/cloud/azure/azure_rm_sqlfirewallrule_facts.py
@@ -17,7 +17,7 @@ DOCUMENTATION = '''
 ---
 module: azure_rm_sqlfirewallrule_facts
 version_added: "2.8"
-short_description: Get Azure SQL Firewall Rule facts.
+short_description: Get Azure SQL Firewall Rule facts
 description:
     - Get facts of SQL Firewall Rule.
 
@@ -38,7 +38,7 @@ extends_documentation_fragment:
     - azure
 
 author:
-    - "Zim Kalinowski (@zikalino)"
+    - Zim Kalinowski (@zikalino)
 
 '''
 
@@ -57,13 +57,14 @@ EXAMPLES = '''
 
 RETURN = '''
 rules:
-    description: A list of dict results containing the facts for matching SQL firewall rules.
+    description:
+        - A list of dict results containing the facts for matching SQL firewall rules.
     returned: always
     type: complex
     contains:
         id:
             description:
-                - Resource ID
+                - Resource ID.
             returned: always
             type: str
             sample: "/subscriptions/xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.Sql/servers/testser
@@ -94,7 +95,7 @@ rules:
             sample: 10.0.0.1
         end_ip_address:
             description:
-                - The start IP address of the firewall rule.
+                - The end IP address of the firewall rule.
             returned: always
             type: str
             sample: 10.0.0.5