remove 'we' from docstrings

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

Hide file tree

Showing 2 changed files with 20 additions and 20 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. We've provided enum :class:`KeyVaultRoleScope`
-            to list the well known scopes, but those scopes are not exhaustive
+        :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.
         :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,8 @@ 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>"
-            We've provided enum :class:`KeyVaultRoleScope` to list the well known scopes, but those scopes are not
-            exhaustive
+            :class:`KeyVaultRoleScope` defines common broad scopes. To list role definitions for a narrower scope,
+            specify it 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 +80,8 @@ 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>"
-            We've provided enum :class:`KeyVaultRoleScope` to list the well known scopes, but those scopes are not
-            exhaustive
+            :class:`KeyVaultRoleScope` defines common broad scopes. To list role definitions for a narrower scope,
+            specify it 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 +97,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. We've provided enum :class:`KeyVaultRoleScope`
-            to list the well known scopes, but those scopes are not exhaustive
+        :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.
         :type role_scope: str or KeyVaultRoleScope
         :rtype: ~azure.core.paging.ItemPaged[KeyVaultRoleAssignment]
         """
@@ -114,8 +114,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. We've provided enum :class:`KeyVaultRoleScope`
-            to list the well known scopes, but those scopes are not exhaustive
+        :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.
         :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
@@ -38,8 +38,8 @@ async def create_role_assignment(
     ) -> KeyVaultRoleAssignment:
         """Create a role assignment.
 
-        :param role_scope: scope the role assignment will apply over. We've provided enum :class:`KeyVaultRoleScope`
-            to list the well known scopes, but those scopes are not exhaustive
+        :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.
         :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,8 @@ async def delete_role_assignment(
         """Delete a role assignment.
 
         :param role_scope: the assignment's scope, for example "/", "/keys", or "/keys/<specific key identifier>".
-            We've provided enum :class:`KeyVaultRoleScope` to list the well known scopes, but those scopes are not
-            exhaustive
+            :class:`KeyVaultRoleScope` defines common broad scopes. To list role definitions for a narrower scope,
+            specify it 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 +89,8 @@ async def get_role_assignment(
         """Get a role assignment.
 
         :param role_scope: the assignment's scope, for example "/", "/keys", or "/keys/<specific key identifier>".
-            We've provided enum :class:`KeyVaultRoleScope` to list the well known scopes, but those scopes are not
-            exhaustive
+            :class:`KeyVaultRoleScope` defines common broad scopes. To list role definitions for a narrower scope,
+            specify it 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
@@ -107,8 +107,8 @@ def list_role_assignments(
     ) -> "AsyncItemPaged[KeyVaultRoleAssignment]":
         """List all role assignments for a scope.
 
-        :param role_scope: scope of the role assignments. We've provided enum :class:`KeyVaultRoleScope`
-            to list the well known scopes, but those scopes are not exhaustive
+        :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.
         :type role_scope: str or KeyVaultRoleScope
         :rtype: ~azure.core.async_paging.AsyncItemPaged[KeyVaultRoleAssignment]
         """
@@ -125,8 +125,8 @@ def list_role_definitions(
     ) -> "AsyncItemPaged[KeyVaultRoleDefinition]":
         """List all role definitions applicable at and above a scope.
 
-        :param role_scope: scope of the role definitions. We've provided enum :class:`KeyVaultRoleScope`
-            to list the well known scopes, but those scopes are not exhaustive
+        :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.
         :type role_scope: str or KeyVaultRoleScope
         :rtype: ~azure.core.async_paging.AsyncItemPaged[KeyVaultRoleDefinition]
         """