diff --git a/lib/ansible/modules/cloud/azure/azure_rm_postgresqlfirewallrule.py b/lib/ansible/modules/cloud/azure/azure_rm_postgresqlfirewallrule.py
index c490429c063..66642198d16 100644
--- a/lib/ansible/modules/cloud/azure/azure_rm_postgresqlfirewallrule.py
+++ b/lib/ansible/modules/cloud/azure/azure_rm_postgresqlfirewallrule.py
@@ -17,7 +17,7 @@ DOCUMENTATION = '''
 ---
 module: azure_rm_postgresqlfirewallrule
 version_added: "2.8"
-short_description: Manage PostgreSQL firewall rule instance.
+short_description: Manage PostgreSQL firewall rule instance
 description:
     - Create, update and delete instance of PostgreSQL firewall rule.
 
@@ -52,7 +52,7 @@ extends_documentation_fragment:
     - azure
 
 author:
-    - "Zim Kalinowski (@zikalino)"
+    - Zim Kalinowski (@zikalino)
 
 '''
 
@@ -69,7 +69,7 @@ EXAMPLES = '''
 RETURN = '''
 id:
     description:
-        - Resource ID
+        - Resource ID.
     returned: always
     type: str
     sample: "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.DBforPostgreSQL/servers/testserver
diff --git a/lib/ansible/modules/cloud/azure/azure_rm_postgresqlfirewallrule_facts.py b/lib/ansible/modules/cloud/azure/azure_rm_postgresqlfirewallrule_facts.py
index 04f33c8fc48..452236a0d8f 100644
--- a/lib/ansible/modules/cloud/azure/azure_rm_postgresqlfirewallrule_facts.py
+++ b/lib/ansible/modules/cloud/azure/azure_rm_postgresqlfirewallrule_facts.py
@@ -17,7 +17,7 @@ DOCUMENTATION = '''
 ---
 module: azure_rm_postgresqlfirewallrule_facts
 version_added: "2.8"
-short_description: Get Azure PostgreSQL Firewall Rule facts.
+short_description: Get Azure PostgreSQL Firewall Rule facts
 description:
     - Get facts of Azure PostgreSQL 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 dictionaries containing facts for PostgreSQL Firewall Rule.
+    description:
+        - A list of dictionaries containing facts for PostgreSQL Firewall Rule.
     returned: always
     type: complex
     contains:
         id:
             description:
-                - Resource ID
+                - Resource ID.
             returned: always
             type: str
             sample: "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/TestGroup/providers/Microsoft.DBforPostgreSQL/servers/testserver/fire