fix docstrings pt.2

Azure · Sep 3, 2020 · 1a6e04f · 1a6e04f
1 parent 2fa74fd
commit 1a6e04f
Show file tree

Hide file tree

Showing 2 changed files with 13 additions and 17 deletions.
diff --git a/...ult/azure-keyvault-administration/azure/keyvault/administration/_access_control_client.py b/...ult/azure-keyvault-administration/azure/keyvault/administration/_access_control_client.py
@@ -31,8 +31,8 @@ def create_role_assignment(self, role_scope, role_assignment_name, role_definiti
         # type: (Union[str, KeyVaultRoleScope], Union[str, UUID], str, str, **Any) -> KeyVaultRoleAssignment
         """Create a role assignment.
 
-        :param role_scope: scope the role assignment will apply over. :class:`KeyVaultRoleScope` defines common broad
-            scopes. To list role definitions for a narrower scope, specify it as a string.
+        :param role_scope: scope the role assignment will apply over. :class:`KeyVaultRoleScope` defines common
+            broad scopes. Specify a narrower scope as a string.
         :type role_scope: str or KeyVaultRoleScope
         :param role_assignment_name: a name for the role assignment. Must be a UUID.
         :type role_assignment_name: str or uuid.UUID
@@ -61,8 +61,7 @@ def delete_role_assignment(self, role_scope, role_assignment_name, **kwargs):
         """Delete a role assignment.
 
         :param role_scope: the assignment's scope, for example "/", "/keys", or "/keys/<specific key identifier>"
-            :class:`KeyVaultRoleScope` defines common broad scopes. To list role definitions for a narrower scope,
-            specify it as a string.
+            :class:`KeyVaultRoleScope` defines common broad scopes. Specify a narrower scope as a string.
         :type role_scope: str or KeyVaultRoleScope
         :param role_assignment_name: the assignment's name. Must be a UUID.
         :type role_assignment_name: str or uuid.UUID
@@ -80,8 +79,7 @@ def get_role_assignment(self, role_scope, role_assignment_name, **kwargs):
         """Get a role assignment.
 
         :param role_scope: the assignment's scope, for example "/", "/keys", or "/keys/<specific key identifier>"
-            :class:`KeyVaultRoleScope` defines common broad scopes. To list role definitions for a narrower scope,
-            specify it as a string.
+            :class:`KeyVaultRoleScope` defines common broad scopes. Specify a narrower scope as a string.
         :type role_scope: str or KeyVaultRoleScope
         :param role_assignment_name: the assignment's name. Must be a UUID.
         :type role_assignment_name: str or uuid.UUID
@@ -97,8 +95,8 @@ def list_role_assignments(self, role_scope, **kwargs):
         # type: (Union[str, KeyVaultRoleScope], **Any) -> ItemPaged[KeyVaultRoleAssignment]
         """List all role assignments for a scope.
 
-        :param role_scope: scope of the role assignments. :class:`KeyVaultRoleScope` defines common broad
-            scopes. To list role definitions for a narrower scope, specify it as a string.
+        :param role_scope: scope of the role assignments. :class:`KeyVaultRoleScope` defines common broad scopes.
+            Specify a narrower scope as a string.
         :type role_scope: str or KeyVaultRoleScope
         :rtype: ~azure.core.paging.ItemPaged[KeyVaultRoleAssignment]
         """
@@ -114,8 +112,8 @@ def list_role_definitions(self, role_scope, **kwargs):
         # type: (Union[str, KeyVaultRoleScope], **Any) -> ItemPaged[KeyVaultRoleDefinition]
         """List all role definitions applicable at and above a scope.
 
-        :param role_scope: scope of the role definitions. :class:`KeyVaultRoleScope` defines common broad
-            scopes. To list role definitions for a narrower scope, specify it as a string.
+        :param role_scope: scope of the role definitions. :class:`KeyVaultRoleScope` defines common broad scopes.
+            Specify a narrower scope as a string.
         :type role_scope: str or KeyVaultRoleScope
         :rtype: ~azure.core.paging.ItemPaged[KeyVaultRoleDefinition]
         """

diff --git a/...azure-keyvault-administration/azure/keyvault/administration/aio/_access_control_client.py b/...azure-keyvault-administration/azure/keyvault/administration/aio/_access_control_client.py
@@ -39,7 +39,7 @@ async def create_role_assignment(
         """Create a role assignment.
 
         :param role_scope: scope the role assignment will apply over. :class:`KeyVaultRoleScope` defines common broad
-            scopes. To list role definitions for a narrower scope, specify it as a string.
+            scopes. Specify a narrower scope as a string.
         :type role_scope: str or KeyVaultRoleScope
         :param role_assignment_name: a name for the role assignment. Must be a UUID.
         :type role_assignment_name: str or uuid.UUID
@@ -69,8 +69,7 @@ async def delete_role_assignment(
         """Delete a role assignment.
 
         :param role_scope: the assignment's scope, for example "/", "/keys", or "/keys/<specific key identifier>".
-            :class:`KeyVaultRoleScope` defines common broad scopes. To list role definitions for a narrower scope,
-            specify it as a string.
+            :class:`KeyVaultRoleScope` defines common broad scopes. Specify a narrower scope as a string.
         :type role_scope: str or KeyVaultRoleScope
         :param role_assignment_name: the assignment's name. Must be a UUID.
         :type role_assignment_name: str or uuid.UUID
@@ -89,8 +88,7 @@ async def get_role_assignment(
         """Get a role assignment.
 
         :param role_scope: the assignment's scope, for example "/", "/keys", or "/keys/<specific key identifier>".
-            :class:`KeyVaultRoleScope` defines common broad scopes. To list role definitions for a narrower scope,
-            specify it as a string.
+            :class:`KeyVaultRoleScope` defines common broad scopes. Specify a narrower scope as a string.
         :type role_scope: str or KeyVaultRoleScope
         :param role_assignment_name: the assignment's name. Must be a UUID.
         :type role_assignment_name: str or uuid.UUID
@@ -108,7 +106,7 @@ def list_role_assignments(
         """List all role assignments for a scope.
 
         :param role_scope: scope of the role assignments. :class:`KeyVaultRoleScope` defines common broad
-            scopes. To list role definitions for a narrower scope, specify it as a string.
+            scopes. Specify a narrower scope as a string.
         :type role_scope: str or KeyVaultRoleScope
         :rtype: ~azure.core.async_paging.AsyncItemPaged[KeyVaultRoleAssignment]
         """
@@ -126,7 +124,7 @@ def list_role_definitions(
         """List all role definitions applicable at and above a scope.
 
         :param role_scope: scope of the role definitions. :class:`KeyVaultRoleScope` defines common broad
-            scopes. To list role definitions for a narrower scope, specify it as a string.
+            scopes. Specify a narrower scope as a string.
         :type role_scope: str or KeyVaultRoleScope
         :rtype: ~azure.core.async_paging.AsyncItemPaged[KeyVaultRoleDefinition]
         """