Update azure_rm_roledefinition related document (#57927)

* Update azure_rm_roledefinition related documentation

lib/ansible/modules/cloud/azure/azure_rm_roledefinition.py

@@ -17,7 +17,7 @@ DOCUMENTATION = '''
 ---
 module: azure_rm_roledefinition
 version_added: "2.8"
-short_description: Manage Azure Role Definition.
+short_description: Manage Azure Role Definition
 description:
     - Create, update and delete instance of Azure Role Definition.
 
@@ -48,16 +48,18 @@ options:
                     - List of denied data actions.
                 type: list
     assignable_scopes:
-        description: List of assignable scope of this definition.
+        description:
+            - List of assignable scopes of this definition.
     scope:
-        description: The scope of the role definition.
+        description:
+            - The scope of the role definition.
     description:
         description:
             - The role definition description.
     state:
         description:
             - Assert the state of the role definition.
-        - Use 'present' to create or update a role definition and 'absent' to delete it.
+            - Use C(present) to create or update a role definition; use C(absent) to delete it.
         default: present
         choices:
             - absent
@@ -67,7 +69,7 @@ extends_documentation_fragment:
     - azure
 
 author:
-    - "Yunge Zhu(@yungezz)"
+    - Yunge Zhu(@yungezz)
 
 '''
 
@@ -87,7 +89,8 @@ EXAMPLES = '''
 
 RETURN = '''
 id:
-    description: Id of current role definition.
+    description:
+        - ID of current role definition.
     returned: always
     type: str
     sample: "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId"

lib/ansible/modules/cloud/azure/azure_rm_roledefinition_facts.py

@@ -17,7 +17,7 @@ DOCUMENTATION = '''
 ---
 module: azure_rm_roledefinition_facts
 version_added: "2.8"
-short_description: Get Azure Role Definition facts.
+short_description: Get Azure Role Definition facts
 description:
     - Get facts of Azure Role Definition.
 
@@ -30,9 +30,11 @@ options:
         description:
             - Role definition id.
     role_name:
-        description: Role name.
+        description:
+            - Role name.
     type:
-        description: Type of role.
+        description:
+            - Type of role.
         choices:
             - system
             - custom
@@ -41,7 +43,7 @@ extends_documentation_fragment:
     - azure
 
 author:
-    - "Yunge Zhu(@yungezz)"
+    - Yunge Zhu(@yungezz)
 
 '''
 
@@ -58,34 +60,38 @@ EXAMPLES = '''
 
 RETURN = '''
 roledefinitions:
-    description: A list of Role Definition facts.
+    description:
+        - A list of Role Definition facts.
     returned: always
     type: complex
     contains:
         id:
-        description: Role Definition id.
+            description:
+                - Role Definition ID.
             returned: always
             type: str
             sample: "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.Authorization/roleDefinitions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
         role_name:
-        description: Role name.
+            description:
+                - Role name.
             returned: always
             type: str
             sample: myCustomRoleDefinition
         name:
-        description: System assigned role name.
+            description:
+                - System assigned role name.
             returned: always
             type: str
             sample: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
         assignable_scopes:
             description:
-            - List of assignable scope of this definition.
+                - List of assignable scopes of this definition.
             returned: always
             type: list
-        sample: "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup"
+            sample: [ "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup" ]
         permissions:
             description:
-            - List of Role Definition peremissions.
+                - List of Role Definition permissions.
             returned: always
             contains:
                 actions:
@@ -93,25 +99,25 @@ roledefinitions:
                         - List of allowed actions.
                     returned: always
                     type: list
-                sample: Microsoft.Compute/virtualMachines/read
+                    sample: [ 'Microsoft.Compute/virtualMachines/read' ]
                 not_actions:
                     description:
                         - List of denied actions.
                     returned: always
                     type: list
-                sample: Microsoft.Compute/virtualMachines/write
+                    sample: [ 'Microsoft.Compute/virtualMachines/write' ]
                 data_actions:
                     description:
                         - List of allowed data actions.
                     returned: always
                     type: list
-                sample: Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read
+                    sample: [ 'Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read' ]
                 not_data_actions:
                     description:
-                    - List of denied actions.
+                        - List of denied data actions.
                     returned: always
                     type: list
-                sample: Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
+                    sample: [ 'Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write' ]
 '''
 
 from ansible.module_utils.azure_rm_common import AzureRMModuleBase