From 293acdbd6e64efda7b4ddeadacec5ba0d15ebb26 Mon Sep 17 00:00:00 2001 From: Stacey Salamon Date: Wed, 13 Sep 2023 19:56:07 +0200 Subject: [PATCH 1/6] Add info on teams migration to groups --- .../howto/create-manage-teams.rst | 20 +++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/docs/tools/aiven-console/howto/create-manage-teams.rst b/docs/tools/aiven-console/howto/create-manage-teams.rst index 1bd79bfd06..791d6edaff 100644 --- a/docs/tools/aiven-console/howto/create-manage-teams.rst +++ b/docs/tools/aiven-console/howto/create-manage-teams.rst @@ -5,7 +5,9 @@ Create and manage teams .. important:: **Teams are becoming groups** - :doc:`Groups ` are an easier way to control access to your organization's projects and services for a group of users. + :doc:`Groups ` are an easier way to control access to your organization's projects and services for a group of users. + + :ref:`migrate_teams_to_groups` **Teams** let you create user groups and assign different access levels to specific projects. Users must be part of an organization before being added to a team. To create and manage teams, click **Admin** and then select **Teams**. @@ -20,7 +22,7 @@ Create a new team #. Click **Create team**. Add users to a team --------------------------- +-------------------- #. Click the name of the team that you want to add users to. @@ -54,3 +56,17 @@ To add projects and roles to a team: #. Click **Add project to team**. You can edit the permissions or delete the project from this team by clicking the more options menu for the project. + +.. _migrate_teams_to_groups: + +Migrate teams to groups +------------------------ + +To help you get started using groups, the migration feature creates new groups from the existing teams in your organization all at once. + +You can do this in two places: + +* In the organization, go to **Admin** > **Organization** > **Teams** . +* In a project, go to **Members** > **Teams**. + +As part of the migration, the members of the account owners team for an organization are made super admin. Super admin have full access to an organization's admin, billing, units, projects, and services. From 2f4d02e56f3ce7e51355d872e5e6952f4dd0dd36 Mon Sep 17 00:00:00 2001 From: Stacey Salamon Date: Thu, 14 Sep 2023 09:04:55 +0200 Subject: [PATCH 2/6] Align content with style guide --- docs/tools/aiven-console/howto/create-manage-teams.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/tools/aiven-console/howto/create-manage-teams.rst b/docs/tools/aiven-console/howto/create-manage-teams.rst index 791d6edaff..f68119dd6b 100644 --- a/docs/tools/aiven-console/howto/create-manage-teams.rst +++ b/docs/tools/aiven-console/howto/create-manage-teams.rst @@ -66,7 +66,7 @@ To help you get started using groups, the migration feature creates new groups f You can do this in two places: -* In the organization, go to **Admin** > **Organization** > **Teams** . -* In a project, go to **Members** > **Teams**. +* In the organization, go to **Admin**, select **Organization**, and then the **Teams** tab. +* In a project, select **Members** and then the **Teams** tab. As part of the migration, the members of the account owners team for an organization are made super admin. Super admin have full access to an organization's admin, billing, units, projects, and services. From 9f43d3f7700681c5b382bb2293177cbc052fc727 Mon Sep 17 00:00:00 2001 From: Stacey Salamon Date: Tue, 26 Sep 2023 18:26:36 +0200 Subject: [PATCH 3/6] Add instructions for manual migration to groups --- .../aiven-console/howto/create-manage-teams.rst | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/docs/tools/aiven-console/howto/create-manage-teams.rst b/docs/tools/aiven-console/howto/create-manage-teams.rst index f68119dd6b..bad15edb34 100644 --- a/docs/tools/aiven-console/howto/create-manage-teams.rst +++ b/docs/tools/aiven-console/howto/create-manage-teams.rst @@ -62,11 +62,18 @@ You can edit the permissions or delete the project from this team by clicking th Migrate teams to groups ------------------------ -To help you get started using groups, the migration feature creates new groups from the existing teams in your organization all at once. +Replace your existing teams with groups: -You can do this in two places: +#. In the organization, click **Admin** -* In the organization, go to **Admin**, select **Organization**, and then the **Teams** tab. -* In a project, select **Members** and then the **Teams** tab. +#. Click **Organization** and on the **Teams** tab view each team to make a note of: -As part of the migration, the members of the account owners team for an organization are made super admin. Super admin have full access to an organization's admin, billing, units, projects, and services. +* which users are members of the team +* which projects the team is assigned to +* the permission level that is assigned for each project + +#. Click **Groups** and then **Create group**. + +#. Enter the name of one of the teams and assign the same users to this group. Do this for each of your organization's teams. + +#. :doc:`Add each new group to the same projects ` that the teams are assigned to. Set the role to the same permission level that is used for the team. From e7239600842797390e47c0540a9d7af90c28f107 Mon Sep 17 00:00:00 2001 From: Stacey Salamon Date: Tue, 26 Sep 2023 18:39:15 +0200 Subject: [PATCH 4/6] Tweak intro --- docs/tools/aiven-console/howto/create-manage-teams.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tools/aiven-console/howto/create-manage-teams.rst b/docs/tools/aiven-console/howto/create-manage-teams.rst index bad15edb34..4108ca9e58 100644 --- a/docs/tools/aiven-console/howto/create-manage-teams.rst +++ b/docs/tools/aiven-console/howto/create-manage-teams.rst @@ -62,7 +62,7 @@ You can edit the permissions or delete the project from this team by clicking th Migrate teams to groups ------------------------ -Replace your existing teams with groups: +To get started using organization groups, replace your existing teams with groups: #. In the organization, click **Admin** From 60556120cb67c0fa311ab26c33536aa246ff359e Mon Sep 17 00:00:00 2001 From: Stacey Salamon Date: Fri, 29 Sep 2023 20:50:52 +0200 Subject: [PATCH 5/6] Add info on account owners --- docs/tools/aiven-console/howto/create-manage-teams.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/tools/aiven-console/howto/create-manage-teams.rst b/docs/tools/aiven-console/howto/create-manage-teams.rst index 4108ca9e58..252b76ffcd 100644 --- a/docs/tools/aiven-console/howto/create-manage-teams.rst +++ b/docs/tools/aiven-console/howto/create-manage-teams.rst @@ -77,3 +77,8 @@ To get started using organization groups, replace your existing teams with group #. Enter the name of one of the teams and assign the same users to this group. Do this for each of your organization's teams. #. :doc:`Add each new group to the same projects ` that the teams are assigned to. Set the role to the same permission level that is used for the team. + +.. important:: + Users on the account owners team automatically become super admin. To give them the same permission level, after deleting the account owners team :doc:`make them super admin `. + +#. After confirming all users have the correct access, delete the teams. From 97f376bb153a8d450ea3c8a0029605de2add511f Mon Sep 17 00:00:00 2001 From: Stacey Salamon Date: Wed, 22 Nov 2023 14:31:57 +0100 Subject: [PATCH 6/6] Fix indenting --- docs/tools/aiven-console/howto/create-manage-teams.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/tools/aiven-console/howto/create-manage-teams.rst b/docs/tools/aiven-console/howto/create-manage-teams.rst index 252b76ffcd..c7eea7d0bc 100644 --- a/docs/tools/aiven-console/howto/create-manage-teams.rst +++ b/docs/tools/aiven-console/howto/create-manage-teams.rst @@ -68,9 +68,9 @@ To get started using organization groups, replace your existing teams with group #. Click **Organization** and on the **Teams** tab view each team to make a note of: -* which users are members of the team -* which projects the team is assigned to -* the permission level that is assigned for each project + * which users are members of the team + * which projects the team is assigned to + * the permission level that is assigned for each project #. Click **Groups** and then **Create group**. @@ -78,7 +78,7 @@ To get started using organization groups, replace your existing teams with group #. :doc:`Add each new group to the same projects ` that the teams are assigned to. Set the role to the same permission level that is used for the team. -.. important:: + .. important:: Users on the account owners team automatically become super admin. To give them the same permission level, after deleting the account owners team :doc:`make them super admin `. #. After confirming all users have the correct access, delete the teams.