From 94916bc46d96836339eafbeda992297e16bdebdb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Gast=C3=B3n=20Fournier?= Date: Tue, 31 Oct 2023 15:00:25 +0100 Subject: [PATCH] docs: improve troubleshooting (#5233) ## About the changes Adding details based on customer struggles --- website/docs/how-to/how-to-troubleshoot-flag-exposure.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/website/docs/how-to/how-to-troubleshoot-flag-exposure.md b/website/docs/how-to/how-to-troubleshoot-flag-exposure.md index 66c17c4134..951a61e898 100644 --- a/website/docs/how-to/how-to-troubleshoot-flag-exposure.md +++ b/website/docs/how-to/how-to-troubleshoot-flag-exposure.md @@ -3,5 +3,6 @@ title: My feature flag is enabled but all/some of our users are not exposed to i --- To confirm how users will have flags resolved, follow these steps: -1. The [Unleash Playground](../reference/playground.mdx) was developed with this particular use case in mind. An access token can be used along with context values (passed in via the UI) to see how a flag will be resolved. -2. When using a **gradual rollout** strategy, be mindful of the **[stickiness](../reference/stickiness)** value. When evaluating a flag, if the provided context does not include the field used in the stickiness configuration, the gradual rollout strategy will be evaluated to `false`. +1. Ensure your application is waiting for the `ready` event: It could be that frontend clients are calling `isEnabled('feature-flag')` before they have the response from the server. In this case, you should defer isEnabled calls until the client has emitted the `ready` event. +2. The [Unleash Playground](../reference/playground.mdx) was developed with this particular use case in mind. An access token can be used along with context values (passed in via the UI) to see how a flag will be resolved. +3. When using a **gradual rollout** strategy, be mindful of the **[stickiness](../reference/stickiness)** value. When evaluating a flag, if the provided context does not include the field used in the stickiness configuration, the gradual rollout strategy will be evaluated to `false`.