summaryrefslogtreecommitdiff
path: root/doc/user/project/members/share_project_with_groups.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/user/project/members/share_project_with_groups.md')
-rw-r--r--doc/user/project/members/share_project_with_groups.md20
1 files changed, 12 insertions, 8 deletions
diff --git a/doc/user/project/members/share_project_with_groups.md b/doc/user/project/members/share_project_with_groups.md
index b9887212be0..d1ee42f723d 100644
--- a/doc/user/project/members/share_project_with_groups.md
+++ b/doc/user/project/members/share_project_with_groups.md
@@ -1,6 +1,6 @@
---
stage: Manage
-group: Workspace
+group: Organization
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments
---
@@ -16,8 +16,16 @@ with `Group 1`, so that both members of `Group 1` and `Group 2` have access to t
When a project is shared with a group:
- All group members, including members of subgroups or projects that belong to the group,
-are assigned the same role in the project.
-Each member's role is displayed in **Project information > Members > Max role**.
+ are assigned the same role in the project.
+ Each member's role is displayed in **Project information > Members**, in the **Max role** column.
+ When sharing a project with a group, a user's assigned **Max role** is the lowest
+ of either:
+
+ - The role assigned in the group membership.
+ - The maximum role selected when sharing the project with the group.
+
+ Assigning a higher maximum role to the group doesn't give group users higher roles than
+ the roles already assigned to them in the group.
- The group is listed in the **Groups** tab.
- The project is listed on the group dashboard.
@@ -28,7 +36,7 @@ Be aware of the restrictions that apply when you share projects with:
## Share projects with groups with a more restrictive visibility level
-You can share projects only down the group's organization structure.
+You can share projects only down the group's organization structure.
This means you can share a project with a group that has a more restrictive
[visibility level](../../public_access.md#project-and-group-visibility) than the project,
but not with a group that has a less restrictive visibility level.
@@ -78,8 +86,4 @@ To share a project with a group:
## Prevent project sharing
-You can prevent members of a group from
-[sharing a project with another group](../members/share_project_with_groups.md).
-This restriction allows for tighter control over project access.
-
For more information, see [Prevent a project from being shared with groups](../../group/access_and_permissions.md#prevent-a-project-from-being-shared-with-groups).