Skip to content

Document client assignment request reliability - #39560

Merged
leoromanovsky merged 16 commits into
masterfrom
leo.romanovsky/document-flag-assignment-reliability
Sep 10, 2026
Merged

Document client assignment request reliability#39560
leoromanovsky merged 16 commits into
masterfrom
leo.romanovsky/document-flag-assignment-reliability

Conversation

@leoromanovsky

@leoromanovsky leoromanovsky commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

Motivation

Client applications need bounded Feature Flags initialization behavior documented against the APIs that are actually released.

Changes

  • Document the first-evaluation-context initialization timeout available in dd-sdk-ios 3.17.0.
  • Document the first-evaluation-context initialization timeout available in dd-sdk-android-flags 3.14.0.
  • Document flagConfigurationFetch, withTimeout, and withRetry from @datadog/openfeature-browser 1.4.0.
  • Add canonical timeout examples to the iOS, Android, and browser setup flows.
  • Remove the unreleased Flutter and Unity documentation changes.

Decisions

  • Distinguish the mobile initialization deadline from the browser's per-request timeout and retry wrappers.
  • Keep the five-second mobile initialization timeout enabled by default; nonpositive values disable it.
  • Keep browser request timeout and retries opt-in and scoped only to flag configuration requests.
  • Use the browser package's canonical five-second timeout with one retry after the initial request.
  • Clarify that the browser helpers are available to npm consumers but not in the CDN bundle.
  • Defer React Native, Flutter, and Unity documentation until their corresponding APIs are released.

@leoromanovsky leoromanovsky changed the title Document client assignment request timeouts and retries Document client assignment request reliability Aug 28, 2026
Document zero-default assignment timeout and retry controls for supported client SDKs, including composable transport examples. Defer React Native until released native dependencies are available.

Environment: Datadog workspace
@leoromanovsky
leoromanovsky force-pushed the leo.romanovsky/document-flag-assignment-reliability branch from bb55615 to a1b96ad Compare August 28, 2026 23:20
@leoromanovsky
leoromanovsky marked this pull request as ready for review September 1, 2026 17:24
@leoromanovsky
leoromanovsky requested a review from a team as a code owner September 1, 2026 17:24
@leoromanovsky

Copy link
Copy Markdown
Contributor Author

/review

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 Automated review by Claude. AI-generated; verify before acting.

Content is accurate and complete. Two blocker-adjacent findings on the new snippets/alert copy, plus one consistency nit.

Reviewed 030aba59578b1c918e736d9f81fb2957934d7f5bworkflow run

Comment thread hugo/content/en/feature_flags/client/flutter.md Outdated
Comment thread hugo/content/en/getting_started/feature_flags/_index.md Outdated
Comment thread hugo/content/en/feature_flags/client/javascript.md Outdated

@aarsilv aarsilv left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice! Thanks for getting this out so fast. Approving assuming the code issues caught by GitHub fixed up.

Comment thread hugo/content/en/feature_flags/client/android.md Outdated
Comment thread hugo/content/en/feature_flags/client/android.md Outdated
Comment thread hugo/content/en/feature_flags/client/flutter.md Outdated
Comment thread hugo/content/en/feature_flags/client/ios.md Outdated
Comment thread hugo/content/en/feature_flags/client/ios.md Outdated
Comment thread hugo/content/en/feature_flags/client/javascript.md Outdated
Comment thread hugo/content/en/feature_flags/client/unity.md Outdated
@hestonhoffman hestonhoffman added the editorial review Waiting on a more in-depth review label Sep 1, 2026

@clreaume clreaume left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

first round of suggestions/comments. please reach out if you need help deciphering any of this!

Comment thread hugo/content/en/feature_flags/client/android.md Outdated
Comment thread hugo/content/en/getting_started/feature_flags/_index.md Outdated
Comment thread hugo/content/en/getting_started/feature_flags/_index.md Outdated
Comment thread hugo/content/en/feature_flags/client/android.md Outdated
Comment thread hugo/content/en/feature_flags/client/android.md Outdated
Comment thread hugo/content/en/feature_flags/client/ios.md Outdated
Comment thread hugo/content/en/feature_flags/client/ios.md Outdated
Comment thread hugo/content/en/feature_flags/client/javascript.md Outdated
Comment thread hugo/content/en/feature_flags/client/javascript.md Outdated
Comment thread hugo/content/en/feature_flags/client/javascript.md Outdated

@clreaume clreaume left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks good, thanks for addressing the feedback!

@leoromanovsky
leoromanovsky merged commit 4cd120f into master Sep 10, 2026
26 of 27 checks passed
@leoromanovsky
leoromanovsky deleted the leo.romanovsky/document-flag-assignment-reliability branch September 10, 2026 22:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

editorial review Waiting on a more in-depth review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants