Make clear that projects are migrated with groups
Problem
Docs and UI do not clearly state that projects are migrated with groups with GitLab Migration.
User feedback:
Anyway to give you a direct feedback, the current gitlab UI indicates that projects are migrated via "Create Project" -> "import Project" -> "Import from Gitlab Export" and groups are being migrated by "Create Group" -> "Import Group". The documentation is also a little bit confusing since the Automate group and project import section is referencing the congregate tool which we can't use as non admins. When I went through the documentation it was not clear to me that "Import Group" is also able to migrate projects. This could be stated clearer in the UI and the documentation.
Proposed solution
-
Adjust documentation in all necessary places. -
Make clear in UI that projects are/can be migrated with groups. We could add a sentence "When migrating a top-level group to GitLab.com, all its subgroups and projects are migrated too." to UI on the page:
or wait for Enable user to not include projects when migrat... (#385689 - closed) to be done, as then the fact of importing projects with groups should be clear enough.
Wdyt @chrismicek @xanf @wortschi?
Related issue for adding affordance in UI: Show GitLab Migration as option when importing ... (#383755 - closed).