From c42f5bbcc1a8a8aaa558b4b826cbb368778b17c8 Mon Sep 17 00:00:00 2001 From: Jason Goodman Date: Thu, 15 Aug 2019 18:16:58 -0400 Subject: Add documentation for feature flag Target Users Add screenshot --- doc/user/project/operations/feature_flags.md | 15 ++++++++++++++- doc/user/project/operations/img/target_users_v12_2.png | Bin 0 -> 42768 bytes 2 files changed, 14 insertions(+), 1 deletion(-) create mode 100644 doc/user/project/operations/img/target_users_v12_2.png diff --git a/doc/user/project/operations/feature_flags.md b/doc/user/project/operations/feature_flags.md index 19ccde6e16a..75b0623e6b0 100644 --- a/doc/user/project/operations/feature_flags.md +++ b/doc/user/project/operations/feature_flags.md @@ -112,6 +112,19 @@ If this strategy is selected, then the Unleash client **must** be given a user i **Percent rollout (logged in users)** is implemented using the Unleash [gradualRolloutUserId](https://unleash.github.io/docs/activation_strategy#gradualrolloutuserid) activation strategy. +## Target Users + +> [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/8240) in GitLab 12.2. + +A feature flag may be enabled for a list of target users. + +![Feature flag target users](img/target_users_v12_2.png) + +CAUTION: **Caution:** +The Unleash client **must** be given a user id for the feature to be enabled for target users. See the [Ruby example](#ruby-application-example) below. + +**Target users** is implemented using the Unleash [userWithId](https://unleash.github.io/docs/activation_strategy#userwithid) activation strategy. + ## Integrating with your application In order to use Feature Flags, you need to first @@ -207,7 +220,7 @@ func main() { Here's an example of how to integrate the feature flags in a Ruby application. -The Unleash client is given a user id for use with a **Percent rollout (logged in users)** rollout strategy. +The Unleash client is given a user id for use with a **Percent rollout (logged in users)** rollout strategy or a list of **Target Users**. ```ruby #!/usr/bin/env ruby diff --git a/doc/user/project/operations/img/target_users_v12_2.png b/doc/user/project/operations/img/target_users_v12_2.png new file mode 100644 index 00000000000..c88d2b7be97 Binary files /dev/null and b/doc/user/project/operations/img/target_users_v12_2.png differ -- cgit v1.2.1