Skip to content
Snippets Groups Projects
Unverified Commit 66c7f759 authored by Evan Read's avatar Evan Read Committed by GitLab
Browse files

Refine and expand wording on user contributions and membership mapping

parent 86d4ed19
No related branches found
No related tags found
No related merge requests found
Loading
Loading
@@ -79,8 +79,11 @@ DETAILS:
> - Full support for mapping inherited membership [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/458834) in GitLab 17.1.
> - Removed from GitLab.com direct transfer migrations in GitLab 17.5 in favor of [the alternative](../../project/import/index.md#user-contribution-and-membership-mapping).
 
This method of user contributions and membership mapping is for self-managed GitLab instances. For the method available
on GitLab.com, see [User contribution and membership mapping](../../project/import/index.md#user-contribution-and-membership-mapping).
This method of user contributions and membership mapping is available for
GitLab self-managed without enabled feature flags.
For information on the other method available for GitLab self-managed
with enabled feature flags and for GitLab.com,
see [User contribution and membership mapping](../../project/import/index.md#user-contribution-and-membership-mapping).
 
Users are never created during a migration. Instead, contributions and membership of users on the source instance are
mapped to users on the destination instance. The type of mapping of a user's membership depends on the
Loading
Loading
Loading
Loading
@@ -84,7 +84,7 @@ difficult, but several tools exist including:
 
DETAILS:
**Tier:** Free, Premium, Ultimate
**Offering:** GitLab.com
**Offering:** GitLab.com, Self-managed
 
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/443557) to direct transfer migrations for self-managed instances in GitLab 17.4 [with flags](../../../administration/feature_flags.md) named `importer_user_mapping` and `bulk_import_importer_user_mapping`. Disabled by default.
 
Loading
Loading
@@ -92,8 +92,14 @@ FLAG:
The availability of this feature is controlled by feature flags.
For more information, see the history.
 
This method of user contributions and membership mapping is enabled for GitLab.com [direct transfer migrations](../../group/import/index.md). For the method available on
self-managed GitLab instances, see [User contributions and membership mapping](../../group/import/direct_transfer_migrations.md#user-contributions-and-membership-mapping).
This method of user contributions and membership mapping is available for
[direct transfer migrations](../../group/import/index.md) on:
- GitLab.com
- GitLab self-managed when two feature flags are enabled
For information on the other method available for GitLab self-managed without enabled feature flags,
see [User contributions and membership mapping](../../group/import/direct_transfer_migrations.md#user-contributions-and-membership-mapping).
 
With user contribution and membership mapping, you can assign imported contributions and memberships to users on the
destination instance after import has completed. Unlike the previous method of user contribution and membership mapping,
Loading
Loading
@@ -108,9 +114,6 @@ Each user on the destination instance that is assigned a mapping can:
attributed to them.
- Reject the assignment.
 
This feature is an [experiment](../../../policy/experiment-beta-support.md). If you find a bug, open an issue in
[epic 12378](https://gitlab.com/groups/gitlab-org/-/epics/12378).
### Requirements
 
- You must be able to create enough users, subject to [user limits](#placeholder-user-limits).
Loading
Loading
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment