diff --git a/lib/ansible/modules/cloud/azure/azure_rm_mariadbserver.py b/lib/ansible/modules/cloud/azure/azure_rm_mariadbserver.py
index e45363388a5..30a2998844a 100644
--- a/lib/ansible/modules/cloud/azure/azure_rm_mariadbserver.py
+++ b/lib/ansible/modules/cloud/azure/azure_rm_mariadbserver.py
@@ -18,7 +18,7 @@ DOCUMENTATION = '''
 ---
 module: azure_rm_mariadbserver
 version_added: "2.8"
-short_description: Manage MariaDB Server instance.
+short_description: Manage MariaDB Server instance
 description:
     - Create, update and delete instance of MariaDB Server.
 
@@ -37,14 +37,17 @@ options:
         suboptions:
             name:
                 description:
-                    - The name of the sku, typically, a letter + Number code, e.g. P3.
+                    - The name of the SKU, typically, tier + family + cores, for example C(B_Gen4_1), C(GP_Gen5_8).
             tier:
                 description:
-                    - The tier of the particular SKU, e.g. Basic.
-                choices: ['basic', 'standard']
+                    - The tier of the particular SKU, for example C(Basic).
+                choices:
+                    - basic
+                    - standard
             capacity:
                 description:
-                    - "The scale up/out capacity, representing server's compute units."
+                    - The scale up/out capacity, representing server's compute units.
+                type: int
             size:
                 description:
                     - The size code, to be interpreted by resource as appropriate.
@@ -54,10 +57,12 @@ options:
     storage_mb:
         description:
             - The maximum storage allowed for a server.
+        type: int
     version:
         description:
             - Server version.
-        choices: ['10.2']
+        choices:
+            - 10.2
     enforce_ssl:
         description:
             - Enable SSL enforcement.
@@ -65,13 +70,13 @@ options:
         default: False
     admin_username:
         description:
-            - "The administrator's login name of a server. Can only be specified when the server is being created (and is required for creation)."
+            - The administrator's login name of a server. Can only be specified when the server is being created (and is required for creation).
     admin_password:
         description:
             - The password of the administrator login.
     create_mode:
         description:
-            - Create mode of SQL Server
+            - Create mode of SQL Server.
         default: Default
     state:
         description:
@@ -86,8 +91,8 @@ extends_documentation_fragment:
     - azure_tags
 
 author:
-    - "Zim Kalinowski (@zikalino)"
-    - "Matti Ranta (@techknowlogick)"
+    - Zim Kalinowski (@zikalino)
+    - Matti Ranta (@techknowlogick)
 
 '''
 
@@ -110,19 +115,19 @@ EXAMPLES = '''
 RETURN = '''
 id:
     description:
-        - Resource ID
+        - Resource ID.
     returned: always
     type: str
     sample: /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.DBforMariaDB/servers/mariadbsrv1b6dd89593
 version:
     description:
-        - 'Server version. Possible values include: C(10.2)'
+        - Server version. Possible values include C(10.2).
     returned: always
     type: str
     sample: 10.2
 state:
     description:
-        - 'A state of a server that is visible to user. Possible values include: C(Ready), C(Dropping), C(Disabled)'
+        - A state of a server that is visible to user. Possible values include C(Ready), C(Dropping), C(Disabled).
     returned: always
     type: str
     sample: Ready
diff --git a/lib/ansible/modules/cloud/azure/azure_rm_mariadbserver_facts.py b/lib/ansible/modules/cloud/azure/azure_rm_mariadbserver_facts.py
index 81a451872d8..8669bd1a276 100644
--- a/lib/ansible/modules/cloud/azure/azure_rm_mariadbserver_facts.py
+++ b/lib/ansible/modules/cloud/azure/azure_rm_mariadbserver_facts.py
@@ -18,7 +18,7 @@ DOCUMENTATION = '''
 ---
 module: azure_rm_mariadbserver_facts
 version_added: "2.8"
-short_description: Get Azure MariaDB Server facts.
+short_description: Get Azure MariaDB Server facts
 description:
     - Get facts of MariaDB Server.
 
@@ -38,8 +38,8 @@ extends_documentation_fragment:
     - azure
 
 author:
-    - "Zim Kalinowski (@zikalino)"
-    - "Matti Ranta (@techknowlogick)"
+    - Zim Kalinowski (@zikalino)
+    - Matti Ranta (@techknowlogick)
 
 '''
 
@@ -56,13 +56,14 @@ EXAMPLES = '''
 
 RETURN = '''
 servers:
-    description: A list of dictionaries containing facts for MariaDB servers.
+    description:
+        - A list of dictionaries containing facts for MariaDB servers.
     returned: always
     type: complex
     contains:
         id:
             description:
-                - Resource ID
+                - Resource ID.
             returned: always
             type: str
             sample: /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.DBforMariaDB/servers/myabdud1223
@@ -92,13 +93,13 @@ servers:
             contains:
                 name:
                     description:
-                        - The name of the SKU
+                        - The name of the SKU.
                     returned: always
                     type: str
                     sample: GP_Gen4_2
                 tier:
                     description:
-                        - The tier of the particular SKU
+                        - The tier of the particular SKU.
                     returned: always
                     type: str
                     sample: GeneralPurpose
@@ -122,7 +123,7 @@ servers:
             sample: False
         admin_username:
             description:
-                - "The administrator's login name of a server."
+                - The administrator's login name of a server.
             returned: always
             type: str
             sample: serveradmin
@@ -145,7 +146,8 @@ servers:
             type: str
             sample: myabdud1223.mys.database.azure.com
         tags:
-            description: Tags assigned to the resource. Dictionary of string:string pairs.
+            description:
+                - Tags assigned to the resource. Dictionary of string:string pairs.
             type: dict
             sample: { tag1: abc }
 '''