From 2fa74fd808ad7429a9dc15be06b47b51bc02b4bf Mon Sep 17 00:00:00 2001 From: iscai-msft Date: Thu, 3 Sep 2020 13:17:35 -0400 Subject: [PATCH] remove 'we' from docstrings --- .../administration/_access_control_client.py | 20 +++++++++---------- .../aio/_access_control_client.py | 20 +++++++++---------- 2 files changed, 20 insertions(+), 20 deletions(-) diff --git a/sdk/keyvault/azure-keyvault-administration/azure/keyvault/administration/_access_control_client.py b/sdk/keyvault/azure-keyvault-administration/azure/keyvault/administration/_access_control_client.py index bad35d8ba315..3647a31594e1 100644 --- a/sdk/keyvault/azure-keyvault-administration/azure/keyvault/administration/_access_control_client.py +++ b/sdk/keyvault/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/" - 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/" - 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/sdk/keyvault/azure-keyvault-administration/azure/keyvault/administration/aio/_access_control_client.py b/sdk/keyvault/azure-keyvault-administration/azure/keyvault/administration/aio/_access_control_client.py index 5f1698880237..d20b3b1bf386 100644 --- a/sdk/keyvault/azure-keyvault-administration/azure/keyvault/administration/aio/_access_control_client.py +++ b/sdk/keyvault/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/". - 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/". - 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] """