Skip to content

Commit d41aeb3

Browse files
openfeaturebotopenfeaturebot
committed
chore: update sdk readmes
Signed-off-by: OpenFeature Bot <109696520+openfeaturebot@users.noreply.github.com>
1 parent 0f7c8c3 commit d41aeb3

17 files changed

Lines changed: 80 additions & 36 deletions

File tree

‎docs/reference/other-technologies/cli.mdx‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -210,6 +210,9 @@ openfeature generate typescript --output ./src/flags
210210

211211
See [here](https://github.com/open-feature/cli/blob/main/docs/commands/openfeature_generate.md) for all available options.
212212

213+
> **_NOTE:_**
214+
> Angular generated code requires `@openfeature/angular-sdk` version `1.1.0` or newer.
215+
213216
### `pull`
214217

215218
Fetch feature flag configurations from a remote source.

‎docs/reference/sdks/client/kotlin.mdx‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ This content has been automatically generated from kotlin-sdk.
1010
Edits should be made here: https://github.com/open-feature/kotlin-sdk
1111
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs
1212

13-
Last updated at Wed Feb 18 2026 08:21:16 GMT+0000 (Coordinated Universal Time)
13+
Last updated at Tue Mar 17 2026 08:23:41 GMT+0000 (Coordinated Universal Time)
1414
-->
1515
import MCPInstall from '@site/src/partials/mcp-install';
1616

@@ -20,8 +20,8 @@ import MCPInstall from '@site/src/partials/mcp-install';
2020
<img alt="Specification" src="https://img.shields.io/static/v1?label=specification&message=v0.8.0&color=yellow&style=for-the-badge" />
2121
</a>
2222

23-
<a href="https://github.com/open-feature/kotlin-sdk/releases/tag/v0.7.1">
24-
<img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v0.7.1&color=blue&style=for-the-badge" />
23+
<a href="https://github.com/open-feature/kotlin-sdk/releases/tag/v0.7.2">
24+
<img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v0.7.2&color=blue&style=for-the-badge" />
2525
</a>
2626

2727
<br/>
@@ -41,10 +41,10 @@ import MCPInstall from '@site/src/partials/mcp-install';
4141
The following [Kotlin Multiplatform Targets](https://www.jetbrains.com/help/kotlin-multiplatform-dev/multiplatform-dsl-reference.html#targets) are supported:
4242

4343
| Supported | Platform | Supported versions |
44-
| --------- | -------------------- | ------------------------------------------------------------------------------ |
44+
| --------- | -------------------- |--------------------------------------------------------------------------------|
4545
| ✅ | Android | SDK 21+ |
4646
| ✅ | JVM | JDK 11+ |
47-
| ✅ | Native | Linux x64 |
47+
| ✅ | Native | Linux x64, iosSimulatorArm64, iosArm64 |
4848
| ❌ | Native | [Other native targets](https://kotlinlang.org/docs/native-target-support.html) |
4949
| ✅ | Javascript (Node.js) | |
5050
| ✅ | Javascript (Browser) | |
@@ -67,7 +67,7 @@ Installation is preferred via Maven Central.
6767
6868
```kotlin
6969
dependencies {
70-
api("dev.openfeature:kotlin-sdk:0.7.1")
70+
api("dev.openfeature:kotlin-sdk:0.7.2")
7171
}
7272
```
7373

@@ -77,7 +77,7 @@ dependencies {
7777
kotlin {
7878
sourceSets {
7979
commonMain.dependencies {
80-
api("dev.openfeature:kotlin-sdk:0.7.1")
80+
api("dev.openfeature:kotlin-sdk:0.7.2")
8181
}
8282
}
8383
}

‎docs/reference/sdks/client/swift.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ This content has been automatically generated from swift-sdk.
1010
Edits should be made here: https://github.com/open-feature/swift-sdk
1111
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs
1212

13-
Last updated at Wed Feb 18 2026 08:21:16 GMT+0000 (Coordinated Universal Time)
13+
Last updated at Tue Mar 17 2026 08:23:41 GMT+0000 (Coordinated Universal Time)
1414
-->
1515
import MCPInstall from '@site/src/partials/mcp-install';
1616

‎docs/reference/sdks/client/web/angular.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ This content has been automatically generated from js-sdk.
1010
Edits should be made here: https://github.com/open-feature/js-sdk
1111
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs
1212

13-
Last updated at Wed Feb 18 2026 08:21:16 GMT+0000 (Coordinated Universal Time)
13+
Last updated at Tue Mar 17 2026 08:23:42 GMT+0000 (Coordinated Universal Time)
1414
-->
1515

1616
<p align="center" class="github-badges">

‎docs/reference/sdks/client/web/index.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ This content has been automatically generated from js-sdk.
1010
Edits should be made here: https://github.com/open-feature/js-sdk
1111
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs
1212

13-
Last updated at Wed Feb 18 2026 08:21:16 GMT+0000 (Coordinated Universal Time)
13+
Last updated at Tue Mar 17 2026 08:23:41 GMT+0000 (Coordinated Universal Time)
1414
-->
1515
import MCPInstall from '@site/src/partials/mcp-install';
1616

‎docs/reference/sdks/client/web/react.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ This content has been automatically generated from js-sdk.
1010
Edits should be made here: https://github.com/open-feature/js-sdk
1111
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs
1212

13-
Last updated at Wed Feb 18 2026 08:21:16 GMT+0000 (Coordinated Universal Time)
13+
Last updated at Tue Mar 17 2026 08:23:41 GMT+0000 (Coordinated Universal Time)
1414
-->
1515
import MCPInstall from '@site/src/partials/mcp-install';
1616

‎docs/reference/sdks/server/dart.mdx‎

Lines changed: 36 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ This content has been automatically generated from dart-server-sdk.
99
Edits should be made here: https://github.com/open-feature/dart-server-sdk
1010
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs
1111

12-
Last updated at Wed Feb 18 2026 08:21:16 GMT+0000 (Coordinated Universal Time)
12+
Last updated at Tue Mar 17 2026 08:23:42 GMT+0000 (Coordinated Universal Time)
1313
-->
1414

1515
<p align="center" class="github-badges">
@@ -19,8 +19,8 @@ Last updated at Wed Feb 18 2026 08:21:16 GMT+0000 (Coordinated Universal Time)
1919
</a>
2020

2121

22-
<a href="https://github.com/open-feature/dart-server-sdk/releases/tag/v0.0.16">
23-
<img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v0.0.16&color=blue&style=for-the-badge" />
22+
<a href="https://github.com/open-feature/dart-server-sdk/releases/tag/v0.0.17">
23+
<img alt="Release" src="https://img.shields.io/static/v1?label=release&message=v0.0.17&color=blue&style=for-the-badge" />
2424
</a>
2525

2626
<a href="https://dart.dev/">
@@ -56,7 +56,7 @@ Dart language version: [3.9.2](https://dart.dev/get-dart/archive)
5656

5757
```yaml
5858
dependencies:
59-
openfeature_dart_server_sdk: ^0.0.16
59+
openfeature_dart_server_sdk: ^0.0.17
6060
```
6161
6262
### Then run:
@@ -123,6 +123,7 @@ See [here](https://pub.dev/documentation/openfeature_dart_server_sdk/latest/) fo
123123
| ✅ | [Providers](#providers) | Integrate with a commercial, open source, or in-house feature management tool. |
124124
| ✅ | [Targeting](#targeting) | Contextually-aware flag evaluation using [evaluation context](/docs/reference/concepts/evaluation-context). |
125125
| ✅ | [Hooks](#hooks) | Add functionality to various stages of the flag evaluation life-cycle. |
126+
| ✅ | [Tracking](#tracking) | Associate user actions with feature flag evaluations for experimentation. |
126127
| ✅ | [Logging](#logging) | Integrate with popular logging packages. |
127128
| ✅ | [Domains](#domains) | Logically bind clients with providers. |
128129
| ✅ | [Eventing](#eventing) | React to state changes in the provider or flag management system. |
@@ -214,13 +215,33 @@ For example, a flag enhancing the appearance of a UI component might drive user
214215

215216
Note that some providers may not support tracking; check the documentation for your provider for more information.
216217

218+
```dart
219+
import 'package:openfeature_dart_server_sdk/open_feature_api.dart';
220+
import 'package:openfeature_dart_server_sdk/feature_provider.dart';
221+
222+
final api = OpenFeatureAPI();
223+
final client = api.getClient('my-app');
224+
225+
// Track a user action associated with a feature flag evaluation
226+
await client.track(
227+
'checkout-completed',
228+
context: EvaluationContext(attributes: {
229+
'user': 'user-123',
230+
}),
231+
trackingDetails: TrackingEventDetails(
232+
value: 99.99,
233+
attributes: {'currency': 'USD'},
234+
),
235+
);
236+
```
237+
217238
### Logging
218239

219240
Note that in accordance with the OpenFeature specification, the SDK doesn't generally log messages during flag evaluation.
220241

221242
#### Logging Hook
222243

223-
The Dart SDK includes a `LoggingHook`, which logs detailed information at key points during flag evaluation, using [TBD](https://github.com/open-feature/dart-server-sdk/blob/main/TBD) structured logging API.
244+
The Dart SDK includes a `LoggingHook`, which logs detailed information at key points during flag evaluation, using the [package:logging](https://pub.dev/packages/logging) structured logging API.
224245
This hook can be particularly helpful for troubleshooting and debugging; simply attach it at the global, client or invocation level and ensure your log level is set to "debug".
225246

226247
##### Usage example
@@ -387,7 +408,7 @@ transactionManager.popContext();
387408

388409
To develop a provider, you need to create a new project and include the OpenFeature SDK as a dependency.
389410
This can be a new repository or included in [the existing contrib repository](https://github.com/open-feature/dart-server-sdk-contrib) available under the OpenFeature organization.
390-
You’ll then need to write the provider by implementing the `FeatureProvider` interface exported by the OpenFeature SDK.
411+
You'll then need to write the provider by implementing the `FeatureProvider` interface exported by the OpenFeature SDK.
391412

392413
```dart
393414
import 'dart:async';
@@ -418,6 +439,15 @@ class MyCustomProvider implements FeatureProvider {
418439
// Clean up resources
419440
}
420441
442+
@override
443+
Future<void> track(
444+
String trackingEventName, {
445+
Map<String, dynamic>? evaluationContext,
446+
TrackingEventDetails? trackingDetails,
447+
}) async {
448+
// Send tracking event to your backend, or no-op if unsupported
449+
}
450+
421451
@override
422452
Future<FlagEvaluationResult<bool>> getBooleanFlag(
423453
String flagKey,

‎docs/reference/sdks/server/dotnet.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ This content has been automatically generated from dotnet-sdk.
1010
Edits should be made here: https://github.com/open-feature/dotnet-sdk
1111
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs
1212

13-
Last updated at Wed Feb 18 2026 08:21:15 GMT+0000 (Coordinated Universal Time)
13+
Last updated at Tue Mar 17 2026 08:23:40 GMT+0000 (Coordinated Universal Time)
1414
-->
1515
import MCPInstall from '@site/src/partials/mcp-install';
1616

‎docs/reference/sdks/server/go.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ This content has been automatically generated from go-sdk.
99
Edits should be made here: https://github.com/open-feature/go-sdk
1010
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs
1111

12-
Last updated at Wed Feb 18 2026 08:21:15 GMT+0000 (Coordinated Universal Time)
12+
Last updated at Tue Mar 17 2026 08:23:40 GMT+0000 (Coordinated Universal Time)
1313
-->
1414
import MCPInstall from '@site/src/partials/mcp-install';
1515

@@ -45,7 +45,7 @@ import MCPInstall from '@site/src/partials/mcp-install';
4545

4646
### Requirements
4747

48-
Go language version: [1.24](https://go.dev/doc/devel/release#go1.24.0)
48+
Go language version: [1.25](https://go.dev/doc/devel/release#go1.25.0)
4949

5050
> [!NOTE]
5151
> The OpenFeature Go SDK only supports currently maintained Go language versions.

‎docs/reference/sdks/server/java.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ This content has been automatically generated from java-sdk.
99
Edits should be made here: https://github.com/open-feature/java-sdk
1010
Once a repo has been updated, docs can be generated by running: yarn update:sdk-docs
1111

12-
Last updated at Wed Feb 18 2026 08:21:15 GMT+0000 (Coordinated Universal Time)
12+
Last updated at Tue Mar 17 2026 08:23:40 GMT+0000 (Coordinated Universal Time)
1313
-->
1414
import MCPInstall from '@site/src/partials/mcp-install';
1515

0 commit comments

Comments
 (0)