docs(feature-flags): add Dart client guide#37809
Draft
leoromanovsky wants to merge 1 commit into
Draft
Conversation
Contributor
Preview links (active after the
|
This comment has been minimized.
This comment has been minimized.
e486252 to
eac0305
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation
Customers using Feature Flags from Dart need a docs path that matches the released
datadog_flagspackage. The client SDK landing page already covers Android, iOS, React Native, Unity, and browser SDKs, but it does not route Dart customers to an installation, initialization, evaluation, and telemetry guide.Changes
This PR adds a Dart client guide under
content/en/feature_flags/client/flutter.md. The filename and URL stay unchanged to keep the docs diff small, but the customer-facing label is Dart. The page documents the standalonedatadog_flagspackage: installation, SDK initialization, client creation, evaluation context, typed flag evaluation, telemetry options, last-known assignment storage, shutdown, and a unit-testing pattern.The page also includes an OpenFeature compatibility note: the current Dart package exposes an OpenFeature-compatible API, but it is not built on the OpenFeature Dart SDK. It directs customers to use the documented APIs directly while Datadog works on an OpenFeature-provider-based integration for Dart and Flutter.
The PR also adds Dart to the client SDK card grid, the Feature Flags side navigation, and the LaunchDarkly migration platform picker. The existing telemetry comparison table now lists the Dart option names for exposures and flag evaluation telemetry.
Decisions
This stack documents only the standalone Dart package. Flutter applications can use
datadog_flagsdirectly from Dart code, but the Flutter SDK plugin integration is intentionally left for a stacked documentation PR that followsDataDog/dd-sdk-flutter#1071.The page stays in the existing plain Markdown Feature Flags client docs instead of adding Cdocs filters, matching the neighboring Android, iOS, React Native, Unity, and browser pages.
The OpenFeature wording is presented as a compatibility note rather than a limitation banner: it sets the correct implementation expectation without implying that customers should wait for the provider-based integration before using Feature Flags in Dart.
Validation
git diff --checkruby -e 'require "yaml"; YAML.load_file("config/_default/menus/main.en.yaml"); ARGV.each { |f| YAML.load_file(f); puts "ok #{f}" }' content/en/feature_flags/client/_index.md content/en/feature_flags/client/flutter.md content/en/feature_flags/guide/migrate_from_launchdarkly.mdpython3shortcode balance check for tabs, code blocks, and site-region blocks in touched Markdown files.partial "markdoc-assets.html" not found. This is not caused by the Dart page diff;make build-cdocsis unavailable in this checkout becauseMakefile.configandlocal/bin/js/cdocs-build.jsare missing.