From b200e7e98d33deae828c23c9966ef9c8a4b433f9 Mon Sep 17 00:00:00 2001 From: HarrietAlexander <153020000+HarrietAlexander@users.noreply.github.com> Date: Wed, 4 Mar 2026 16:28:14 +1300 Subject: [PATCH 1/2] Update index.md Updated to "preview" and clean up of the original docs --- src/pages/docs/feature-toggles/index.md | 32 ++++++++++++------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/src/pages/docs/feature-toggles/index.md b/src/pages/docs/feature-toggles/index.md index 367b83297f..30e4b24f3f 100644 --- a/src/pages/docs/feature-toggles/index.md +++ b/src/pages/docs/feature-toggles/index.md @@ -1,7 +1,7 @@ --- layout: src/layouts/Default.astro pubDate: 2025-05-21 -modDate: 2025-05-21 +modDate: 2026-03-04 title: Feature Toggles navTitle: Feature Toggles navSection: Feature Toggles @@ -9,22 +9,22 @@ description: Octopus Feature Toggles allow progressive delivery of changes and i navOrder: 95 --- -Octopus Feature Toggles support toggling features on or off in real-time, without redeploying, and progressively releasing changes to subsets of your users. +Octopus Feature Toggles let you turn features on or off in real time, without redeployment. This enables you to progressively release changes to a subset of your users. :::div{.hint} -Octopus Feature Toggles are currently in Alpha, available to a small set of customers. +Octopus Feature Toggles are currently in Preview, available to a limited group of customers. -If you are interested in this feature please register your interest on the [roadmap card](https://roadmap.octopus.com/c/121-feature-toggles) and we'll keep you updated. +If you are interested in this feature please register your interest on the [roadmap card](https://roadmap.octopus.com/c/121-feature-toggles). We will keep you updated. ::: ## Usage ### Create a Feature Toggle -Feature Toggles are located within Octopus Projects: +You can find Feature Toggles within Octopus Projects: **Project ➜ Feature Toggles** -Create a new Toggle and give it name. +Create a new Toggle and name it ![New toggle name](/docs/img/feature-toggles/new-toggle-name.png) @@ -36,15 +36,15 @@ Follow the [OpenFeature guide for installing the SDK for your language](https:// Configure OpenFeature to use the [Octopus Provider](#providers). -The Octopus OpenFeature Provider requires a client identifier when instantiated. This is a [JWT](https://jwt.io/introduction) which specifies the Octopus Project, Environment, and Tenant (if applicable). This tells the Octopus Feature Toggle service which set of toggles to evaluate. +The Octopus OpenFeature Provider requires a client identifier when instantiated. This identifier is a [JWT](https://jwt.io/introduction) that specifies the Octopus Project, Environment, and Tenant (if applicable). It tells the Octopus Feature Toggle service which set of toggles to evaluate. :::div{.hint} The Octopus Feature Toggle client identifier is available via the Octopus variable `Octopus.FeatureToggles.ClientIdentifier` or via the Feature Toggle UI (see below). ::: -For applications deployed by Octopus, the recommended way is to have Octopus inject the client identifier as part of deployment, for example by injecting it into a configuration file or environment variable. The client identifier is made available via the Octopus variable `Octopus.FeatureToggles.ClientIdentifier`. +For applications deployed by Octopus, the recommended approach is to have Octopus inject the client identifier as during your deployment, for example, injecting it into a configuration file or environment variable. The client identifier is made available via the Octopus variable `Octopus.FeatureToggles.ClientIdentifier`. -For applications not deployed by Octopus, or cannot have the client identifier supplied during deployment for any reason, the client identifier can be obtained via the portal UI, as shown below. +For applications not deployed by Octopus, or those that cannot have the client identifer supplied during deployment, r cannot have the client identifier supplied during deployment, the client identifier can be obtained through the portal UI, as shown below. ![Client identifier preview menu item](/docs/img/feature-toggles/client-identifier-preview-menu-item.png) @@ -62,7 +62,7 @@ For example, an ASP.NET application could have an `appsettings.json` file which } ``` -This would be transformed during deployment by Octopus to contain the correct client identifier for the current Project and Environment. +During deployment, Octopus transforms this to contain the correct client identified for the current Project and Environment. This would then be used during application startup to configure the OpenFeature with the Octopus Provider, similar to: @@ -99,7 +99,7 @@ To enable your toggle for an environment, add the environment to the Toggle. ![Add Environment button](/docs/img/feature-toggles/add-environment-button.png) -Select your environment, and whether you want the toggle on or off. +Select your environment, and choose whether to toggle it on or off. ![Add Environment dialog](/docs/img/feature-toggles/add-environment-dialog.png) @@ -122,7 +122,7 @@ Configuring the providers is documented in the README files in the repositories. Segments allow enabling a toggle for a subset of users. -Segments are key/value pairs, and are supplied by your applications via the [OpenFeature EvaluationContext](https://openfeature.dev/docs/reference/concepts/evaluation-context). +Segments are key/value pairs supplied by your applications via the [OpenFeature EvaluationContext](https://openfeature.dev/docs/reference/concepts/evaluation-context). Common segment examples include: @@ -139,7 +139,7 @@ The Evaluation Context can be supplied at different points in your application, - During each web request - At the evaluation site -The following example shows adding a key/value to the evaluation context in C#. +The following example shows how to add key/value pair to the evaluation context in C#. ```cs // The client would be injected by IoC in many cases @@ -184,12 +184,12 @@ Toggle default values are configured both on the Toggle in Octopus, and at the e The default value on the Toggle in Octopus will be returned if the environment being evaluated has not been configured with an explicit value. -In the example below, the `Production` and `Staging` environments have values configured. The default value for the Toggle is `Off`. If an evaluation is made by an application running in the `Development` environment, or any other environment not configured, it would receive the default value (`Off`). +In the example below, the `Production` and `Staging` environments have values configured. The default value for the Toggle is `off`. If an evaluation is made by an application running in the `Development` environment or any other environment not configured, it would receive the default value (`off`). ![Default Values](/docs/img/feature-toggles/default-values.png) -The default value supplied in client code (the `false` argument in the example below) will only be used if the Octopus Feature Toggle service cannot be reached, for example if there are network issues or the service is unavailable. +The default value supplied in the client code (the `false` argument in the example below) will only be used if the Octopus Feature Toggle service cannot be reached, for example, due to network issues or unavailability. ```cs var darkModeEnabled = await featureClient.GetBooleanValueAsync("dark-mode", false); -``` \ No newline at end of file +``` From 3dc54b02b0c901b1042765201a6e3bebd4e76042 Mon Sep 17 00:00:00 2001 From: Steve Fenton <99181436+steve-fenton-octopus@users.noreply.github.com> Date: Fri, 6 Mar 2026 08:04:47 +0000 Subject: [PATCH 2/2] Typo and lint errors --- src/pages/docs/feature-toggles/index.md | 54 ++++++++++++------------- 1 file changed, 27 insertions(+), 27 deletions(-) diff --git a/src/pages/docs/feature-toggles/index.md b/src/pages/docs/feature-toggles/index.md index 30e4b24f3f..fa8f3cbbe0 100644 --- a/src/pages/docs/feature-toggles/index.md +++ b/src/pages/docs/feature-toggles/index.md @@ -3,8 +3,6 @@ layout: src/layouts/Default.astro pubDate: 2025-05-21 modDate: 2026-03-04 title: Feature Toggles -navTitle: Feature Toggles -navSection: Feature Toggles description: Octopus Feature Toggles allow progressive delivery of changes and instant rollback navOrder: 95 --- @@ -12,14 +10,14 @@ navOrder: 95 Octopus Feature Toggles let you turn features on or off in real time, without redeployment. This enables you to progressively release changes to a subset of your users. :::div{.hint} -Octopus Feature Toggles are currently in Preview, available to a limited group of customers. +Octopus Feature Toggles are currently in Preview, available to a limited group of customers. If you are interested in this feature please register your interest on the [roadmap card](https://roadmap.octopus.com/c/121-feature-toggles). We will keep you updated. ::: -## Usage +## Usage -### Create a Feature Toggle +### Create a Feature Toggle You can find Feature Toggles within Octopus Projects: **Project ➜ Feature Toggles** @@ -32,19 +30,19 @@ Create a new Toggle and name it Octopus Feature Toggles rely on [OpenFeature](https://openfeature.dev/) as the client SDK. -Follow the [OpenFeature guide for installing the SDK for your language](https://openfeature.dev/ecosystem?instant_search%5BrefinementList%5D%5Btype%5D%5B0%5D=SDK) into your application. +Follow the [OpenFeature guide for installing the SDK for your language](https://openfeature.dev/ecosystem?instant_search%5BrefinementList%5D%5Btype%5D%5B0%5D=SDK) into your application. Configure OpenFeature to use the [Octopus Provider](#providers). The Octopus OpenFeature Provider requires a client identifier when instantiated. This identifier is a [JWT](https://jwt.io/introduction) that specifies the Octopus Project, Environment, and Tenant (if applicable). It tells the Octopus Feature Toggle service which set of toggles to evaluate. :::div{.hint} -The Octopus Feature Toggle client identifier is available via the Octopus variable `Octopus.FeatureToggles.ClientIdentifier` or via the Feature Toggle UI (see below). +The Octopus Feature Toggle client identifier is available via the Octopus variable `Octopus.FeatureToggles.ClientIdentifier` or via the Feature Toggle UI (see below). ::: -For applications deployed by Octopus, the recommended approach is to have Octopus inject the client identifier as during your deployment, for example, injecting it into a configuration file or environment variable. The client identifier is made available via the Octopus variable `Octopus.FeatureToggles.ClientIdentifier`. +For applications deployed by Octopus, the recommended approach is to have Octopus inject the client identifier as during your deployment, for example, injecting it into a configuration file or environment variable. The client identifier is made available via the Octopus variable `Octopus.FeatureToggles.ClientIdentifier`. -For applications not deployed by Octopus, or those that cannot have the client identifer supplied during deployment, r cannot have the client identifier supplied during deployment, the client identifier can be obtained through the portal UI, as shown below. +For applications not deployed by Octopus, or those that cannot have the client identifier supplied during deployment, r cannot have the client identifier supplied during deployment, the client identifier can be obtained through the portal UI, as shown below. ![Client identifier preview menu item](/docs/img/feature-toggles/client-identifier-preview-menu-item.png) @@ -52,7 +50,7 @@ For applications not deployed by Octopus, or those that cannot have the client i The previewed client identifier may then be copied into your application configuration. -For example, an ASP.NET application could have an `appsettings.json` file which contained the following: +For example, an ASP.NET application could have an `appsettings.json` file which contained the following: ```json { @@ -62,7 +60,7 @@ For example, an ASP.NET application could have an `appsettings.json` file which } ``` -During deployment, Octopus transforms this to contain the correct client identified for the current Project and Environment. +During deployment, Octopus transforms this to contain the correct client identified for the current Project and Environment. This would then be used during application startup to configure the OpenFeature with the Octopus Provider, similar to: @@ -94,8 +92,9 @@ var darkModeEnabled = await featureClient.GetBooleanValueAsync("dark-mode", fals The second argument is the default value. Read more about [default values](#default-values) below. -### Rollout -To enable your toggle for an environment, add the environment to the Toggle. +### Rollout + +To enable your toggle for an environment, add the environment to the Toggle. ![Add Environment button](/docs/img/feature-toggles/add-environment-button.png) @@ -110,27 +109,28 @@ You can additionally target specific [Tenants](#tenants) or [User Segments](#seg Below are the Octopus OpenFeature provider SDKs currently available: ### Server SDKs + - [.NET](https://github.com/OctopusDeploy/openfeature-provider-dotnet) - [Java](https://github.com/OctopusDeploy/openfeature-provider-java) ### Web SDKs + - [TypeScript/JavaScript](https://github.com/OctopusDeploy/openfeature-provider-ts-web) Configuring the providers is documented in the README files in the repositories. ## Segments {#segments} -Segments allow enabling a toggle for a subset of users. +Segments allow enabling a toggle for a subset of users. Segments are key/value pairs supplied by your applications via the [OpenFeature EvaluationContext](https://openfeature.dev/docs/reference/concepts/evaluation-context). - Common segment examples include: - Specific users. e.g. `user-id/123456` -- Specific accounts. e.g. `account-id/123456` +- Specific accounts. e.g. `account-id/123456` - License types. e.g. `license-type/free` -- Geographic regions. e.g. `region/eu` +- Geographic regions. e.g. `region/eu` - Rollout rings. e.g. `ring/early-adopter` The Evaluation Context can be supplied at different points in your application, for example: @@ -152,20 +152,20 @@ Segments can then be configured for Environments on the Feature Toggle in Octopu ![Add Segment](/docs/img/feature-toggles/segment-add.png) -A Toggle evaluation will match on segments if the evaluation context matches at least one segment for each key. +A Toggle evaluation will match on segments if the evaluation context matches at least one segment for each key. Some examples: -|Segments | Evaluation Context | Result | -|-----------|--------------------|--------| -| `user-id/123456` | `user-id/123456` | `On` | -| `user-id/123456` | `user-id/789383` | `Off` | -| `license-type/free` `region/Asia` `region/EU` | `license-type/free` `region/Asia` | `On` | -| `license-type/free` `region/Asia` `region/EU` | `license-type/free` `region/US` | `Off` | +| Segments | Evaluation Context | Result | +| --------------------------------------------- | --------------------------------- | ------ | +| `user-id/123456` | `user-id/123456` | `On` | +| `user-id/123456` | `user-id/789383` | `Off` | +| `license-type/free` `region/Asia` `region/EU` | `license-type/free` `region/Asia` | `On` | +| `license-type/free` `region/Asia` `region/EU` | `license-type/free` `region/US` | `Off` | ## Tenants {#tenants} -If your Project uses [Tenants](/docs/tenants/), then Toggles may be enabled for subsets of your Tenants. +If your Project uses [Tenants](/docs/tenants/), then Toggles may be enabled for subsets of your Tenants. The options for configuring a Feature Toggle for Tenants are: @@ -174,13 +174,13 @@ The options for configuring a Feature Toggle for Tenants are: - % of Tenants - Specific Tenants Excluded -For example, the configuration shown below will result in the Toggle evaluating as `On` for 10% of Tenants, always including `Acme` and never including `Cyberdyne Systems`. +For example, the configuration shown below will result in the Toggle evaluating as `On` for 10% of Tenants, always including `Acme` and never including `Cyberdyne Systems`. ![Tenanted Rollout](/docs/img/feature-toggles/tenant-rollout.png) ## Default Values {#default-values} -Toggle default values are configured both on the Toggle in Octopus, and at the evaluation site in your client application. It's important to understand how these interact. +Toggle default values are configured both on the Toggle in Octopus, and at the evaluation site in your client application. It's important to understand how these interact. The default value on the Toggle in Octopus will be returned if the environment being evaluated has not been configured with an explicit value.