Update docstrs

Author: aliu39

packages/browser/src/integrations/featureFlags/featureFlagsIntegration.ts

@@ -12,9 +12,8 @@ export interface FeatureFlagsIntegration extends Integration {
 }
 
 /**
- * Sentry integration for buffering feature flags manually with an API, and
- * capturing them on error events. We recommend you do this on each flag
- * evaluation. Flags are buffered per Sentry scope and limited to 100 per event.
+ * Sentry integration for buffering feature flag evaluations manually with an API, and
+ * capturing them on error events and spans.
  *
  * See the [feature flag documentation](https://develop.sentry.dev/sdk/expected-features/#feature-flags) for more information.
  *

packages/browser/src/integrations/featureFlags/launchdarkly/integration.ts

@@ -9,7 +9,7 @@ import {
 import type { LDContext, LDEvaluationDetail, LDInspectionFlagUsedHandler } from './types';
 
 /**
- * Sentry integration for capturing feature flags from LaunchDarkly.
+ * Sentry integration for capturing feature flag evaluations from LaunchDarkly.
  *
  * See the [feature flag documentation](https://develop.sentry.dev/sdk/expected-features/#feature-flags) for more information.
  *
@@ -40,10 +40,10 @@ export const launchDarklyIntegration = defineIntegration(() => {
 }) satisfies IntegrationFn;
 
 /**
- * LaunchDarkly hook that listens for flag evaluations and updates the `flags`
- * context in our Sentry scope. This needs to be registered as an
- * 'inspector' in LaunchDarkly initialize() options, separately from
- * `launchDarklyIntegration`. Both are needed to collect feature flags on error.
+ * LaunchDarkly hook to listen for and buffer flag evaluations. This needs to
+ * be registered as an 'inspector' in LaunchDarkly initialize() options,
+ * separately from `launchDarklyIntegration`. Both the hook and the integration
+ * are needed to capture LaunchDarkly flags.
  */
 export function buildLaunchDarklyFlagUsedHandler(): LDInspectionFlagUsedHandler {
   return {

packages/browser/src/integrations/featureFlags/openfeature/integration.ts

@@ -1,9 +1,17 @@
 /**
- * OpenFeature integration.
+ * Sentry integration for capturing OpenFeature feature flag evaluations.
  *
- * Add the openFeatureIntegration() function call to your integration lists.
- * Add the integration hook to your OpenFeature object.
- *   - OpenFeature.getClient().addHooks(new OpenFeatureIntegrationHook());
+ * See the [feature flag documentation](https://develop.sentry.dev/sdk/expected-features/#feature-flags) for more information.
+ *
+ * @example
+ * ```
+ * import * as Sentry from "@sentry/browser";
+ * import { OpenFeature } from "@openfeature/web-sdk";
+ *
+ * Sentry.init(..., integrations: [Sentry.openFeatureIntegration()]);
+ * OpenFeature.setProvider(new MyProviderOfChoice());
+ * OpenFeature.addHooks(new Sentry.OpenFeatureIntegrationHook());
+ * ```
  */
 import type { Client, Event, EventHint, IntegrationFn, Span } from '@sentry/core';
 import { defineIntegration } from '@sentry/core';