Skip to content

Add feature toggle rollout groups docs#3183

Merged
dylanlerch merged 7 commits into
mainfrom
claude/sharp-hodgkin-0c5373
May 29, 2026
Merged

Add feature toggle rollout groups docs#3183
dylanlerch merged 7 commits into
mainfrom
claude/sharp-hodgkin-0c5373

Conversation

@dylanlerch
Copy link
Copy Markdown
Contributor

@dylanlerch dylanlerch commented May 27, 2026

Adds documentation for feature toggle rollout groups.

Part of DEVEX-319

@team-marketing-branch-protections
Copy link
Copy Markdown

Pull request environment is available at https://stoctodocspr3183.z22.web.core.windows.net.

You can view the ephemeral environment status in Octopus Deploy.

This environment will be automatically deprovisioned when the pull request is closed, or after 7 days of inactivity.

@dylanlerch dylanlerch marked this pull request as ready for review May 28, 2026 01:02
@dylanlerch dylanlerch changed the title Add rollout groups section to feature toggle targeting docs Add feature toggle rollout groups section docs May 28, 2026
@dylanlerch dylanlerch requested a review from a team May 28, 2026 02:09
@dylanlerch dylanlerch changed the title Add feature toggle rollout groups section docs Add feature toggle rollout groups docs May 28, 2026
Comment thread src/pages/docs/feature-toggles/targeting.md Outdated
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.

Was this intended?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

It was not. 😄

Comment thread src/pages/docs/feature-toggles/targeting.md Outdated
Comment thread src/pages/docs/feature-toggles/targeting.md
Comment thread src/pages/docs/feature-toggles/targeting.md
![Screenshot of feature toggle page showing rollout group selector expanded with new onboarding flow group selected](/docs/img/feature-toggles/rollout-group-selector.png)

:::div{.warning}
Adding or removing a rollout group changes the set of tenants or clients included in the rollout. If you have a tenant or client rollout configured, assigning a rollout group will change which tenants or clients are included.
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.

Are these two sentences saying the same thing?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I felt like it was saying slightly different things:

  • Generic behaviour
  • Impact on you

But doing it in a terrible way. I think I need to keep a bit of both. Might go for:

If you have a tenant or client rollout configured, adding or removing a rollout group will change which tenants or clients are included in that rollout.

Comment thread src/pages/docs/feature-toggles/targeting.md Outdated
Comment thread src/pages/docs/feature-toggles/targeting.md Outdated
![Screenshot of feature toggle page showing rollout group selector expanded with new onboarding flow group selected](/docs/img/feature-toggles/rollout-group-selector.png)

:::div{.warning}
Adding or removing a rollout group changes the set of tenants or clients included in the rollout. If you have a tenant or client rollout configured, assigning a rollout group will change which tenants or clients are included.
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.

Nit:

Adding or removing a rollout group on a feature toggle changes the set of tenants or clients included in the toggle's rollout.


## Rollout groups {#rollout-groups}

A percentage rollout on one feature toggle will include a different set of tenants or clients than the same percentage rollout on another toggle by default. This ensures the same tenants or clients are not always the first to receive every new feature.
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.

Nit: IMaybe just style, but I'd find this simpler to read:

By default, percentage rollout on one feature toggle will include a different set of tenants or clients than the same percentage rollout on another toggle. This ensures that one set of tenants or clients is not always the first to receive every new feature.

Copy link
Copy Markdown
Contributor

@caitlynstocker caitlynstocker left a comment

Choose a reason for hiding this comment

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

Approved. Looks good 🛼

@dylanlerch dylanlerch requested a review from liamhughes May 29, 2026 00:47
@dylanlerch dylanlerch force-pushed the claude/sharp-hodgkin-0c5373 branch from cc04c98 to 338db3c Compare May 29, 2026 01:25
@dylanlerch dylanlerch enabled auto-merge (squash) May 29, 2026 01:26
@dylanlerch dylanlerch merged commit 15c9f67 into main May 29, 2026
5 checks passed
@dylanlerch dylanlerch deleted the claude/sharp-hodgkin-0c5373 branch May 29, 2026 01:42
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.

4 participants