Skip to content

Conversation

@sameerank
Copy link

@sameerank sameerank commented Dec 9, 2025

Add setup documentation for using Datadog Feature Flags with Ruby applications. Includes installation, configuration, and usage examples for all flag types.

Not yet in https://github.com/DataDog/dd-trace-rb/releases but will be with 2.23.0

What does this PR do? What is the motivation?

Merge instructions

Merge readiness:

  • Ready for merge

For Datadog employees:

Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). Without this format, your pull request will not pass CI, the GitLab pipeline will not run, and you won't get a branch preview. Getting a branch preview makes it easier for us to check any issues with your PR, such as broken links.

If your branch doesn't follow this format, rename it or create a new branch and PR.

[6/5/2025] Merge queue has been disabled on the documentation repo. If you have write access to the repo, the PR has been reviewed by a Documentation team member, and all of the required checks have passed, you can use the Squash and Merge button to merge the PR. If you don't have write access, or you need help, reach out in the #documentation channel in Slack.

Additional notes

@github-actions
Copy link
Contributor

github-actions bot commented Dec 9, 2025

Preview links (active after the build_preview check completes)

Modified Files

Before setting up the Ruby Feature Flags SDK, ensure you have:

- **Datadog Agent** with [Remote Configuration][1] enabled
- **Datadog Ruby tracer** `datadog` version 2.23.0 or later
Copy link
Author

Choose a reason for hiding this comment

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

Not yet published. Assuming this will be in the next minor release https://github.com/DataDog/dd-trace-rb/releases

client = OpenFeature::SDK.build_client
```

The client returns default values until remote configuration loads in the background. This approach keeps your application responsive during startup but may serve defaults for early requests.
Copy link
Author

@sameerank sameerank Dec 9, 2025

Choose a reason for hiding this comment

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

Provider eventing is not yet supported in OpenFeature: https://github.com/open-feature/ruby-sdk?tab=readme-ov-file#eventing

Eventing is needed for proper separation of non-blocking-vs-blocking between set_provider vs set_provider_and_wait so I'm leaving that out of the docs for now. I'm currently working on a pull request to get OpenFeature's set_provider_and_wait to match the event-based OpenFeature spec and then I can add a section for the blocking version of setting the provider to this doc (which is likely a common use-case)

@sameerank sameerank marked this pull request as ready for review December 9, 2025 22:20
@sameerank sameerank requested a review from a team as a code owner December 9, 2025 22:20
@sameerank sameerank changed the base branch from master to lr/server-sdk-overview-docs December 9, 2025 22:23
@sameerank sameerank requested review from a team as code owners December 9, 2025 22:23
@sameerank sameerank requested a review from calvarjorge December 9, 2025 22:23
@sameerank sameerank marked this pull request as draft December 9, 2025 22:25
@sameerank sameerank removed request for a team and calvarjorge December 9, 2025 22:25
- Port content from setup/ruby.md to server/ruby.md
- Maintain all Vale linting fixes from previous commits
- Include prerequisites, installation, usage examples, and troubleshooting
- Support for boolean, string, number, object flags and evaluation context
@sameerank sameerank force-pushed the sameerank/feature-flags-ruby branch from 44b7ec5 to 955af79 Compare December 9, 2025 22:33
@sameerank
Copy link
Author

Whoops sorry about the mess above. I had mistakenly started the branch off master 😅

@sameerank sameerank requested a review from joepeeples December 9, 2025 22:37
@sameerank sameerank marked this pull request as ready for review December 9, 2025 22:38

- **Datadog Agent** with [Remote Configuration][1] enabled
- **Datadog Ruby tracer** `datadog` version 2.23.0 or later
- **OpenFeature Ruby SDK** `openfeature-sdk` version 0.4.1 or later
Copy link
Contributor

Choose a reason for hiding this comment

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

👍

@sameerank sameerank merged commit d589d53 into lr/server-sdk-overview-docs Dec 10, 2025
14 checks passed
@sameerank sameerank deleted the sameerank/feature-flags-ruby branch December 10, 2025 20:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants