Skip to content

Clarify required permissions for Gitlab Migration

Release Notes

GitLab Migration requires Owner permissions in order to migrate groups. However, before GitLab 15.1, there was no hint about this required permissions, which created confusions for users without the Owner permission, when some groups where not visible for them in the Import page. In this milestone, we added a dismissible notification that tells the user that only groups that the user is the Owner of them are visible.

We are requiring Owner permissions in order to migrate group. This is required because we are using ndjson files as part of import. However, for end user there is no hint about required permissions - I've heard multiple reports from end users confused "why my group is not visible"

Original suggestion (outdated) I suggest adding dismissible notification about Owner permission

image

Link "Owner role" should point to Group member permissions table in docs, where we should add Gitlab migration indicating as available only to group owner

Please note that second alert about running outdated version is not related to this issue and is added only for illustrative purposes how it will look when both alerts are present. For most of scenarios user will only see the blue one

As usual, suggestions for proper text are welcome!

We will need to change following:

  • pagination text in UI from: Showing 1-5 of 5 groups that you own from https://gitlab.com to: Showing 1-5 of 5 groups that you own from https://gitlab.com with added help icon and tooltip with text
What is listed here?
--------------------
Only groups that you have the Owner role for are listed as groups you can import.
  • empty state text when no groups are present to You don't have Owner role for any groups in this instance

Owner should link to https://docs.gitlab.com/ee/user/permissions.html#group-members-permissions) table in docs, where we should add Gitlab migration indicating as available only to group owner

Implementation plan

Edited by Itzik Gan Baruch