Skip to content

docs: expand enrollment state machine into an enrollment lifecycle page - #835

Merged
jaredlockhart merged 4 commits into
mainfrom
enrollment-lifecycle-doc
Jul 28, 2026
Merged

docs: expand enrollment state machine into an enrollment lifecycle page#835
jaredlockhart merged 4 commits into
mainfrom
enrollment-lifecycle-doc

Conversation

@jaredlockhart

@jaredlockhart jaredlockhart commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

Because

  • The enrollment page was sparse and did not answer the questions people actually ask about a live recipe: when is enrollment re-evaluated, what persists across syncs, does resizing a rollout capture previously not-selected clients, and does sticky enrollment affect bucketing.
  • It described only the mobile SDK, even though the desktop client implements the same model.

This commit

  • Adds an evaluation-sequence flowchart (feature conflict, app/channel, targeting, bucketing) and a "what persists across evaluations" table.
  • Adds a "what changes when you edit a live recipe" table scoped to the edits Experimenter actually allows (resize a rollout, end enrollment, end the recipe), plus a note that targeting/branches/feature values are locked at launch and require a clone.
  • Clarifies that sticky enrollment gates only targeting for already-enrolled clients, and does not affect bucketing or not-enrolled clients.
  • Covers both clients and collects the mobile/desktop differences in one table.
  • Renames the page to Enrollment Lifecycle and moves it under Platform Guides (file, id, and slug updated to match).

Because

* The page was sparse and did not explain when enrollment is re-evaluated,
  what persists across syncs, or what a change to a live recipe does, which
  are the questions people actually ask (e.g. does resizing a rollout capture
  previously not-selected clients, and does sticky affect bucketing).
* It only described the mobile SDK, despite desktop implementing the same model.

This commit

* Adds sections for the evaluation sequence, what persists across evaluations,
  and a "what changes when you edit a live recipe" reference table.
* Clarifies that sticky enrollment gates only targeting for enrolled clients,
  and does not affect bucketing or not-enrolled clients.
* Documents both clients and collects the mobile/desktop differences in one table.
* Renames the page to Enrollment Lifecycle (id and slug unchanged).
Move docs/advanced/enrollment-state-machine.md to
docs/platform-guides/enrollment-lifecycle.md, and update its id and slug to
match the Enrollment Lifecycle title and its Platform Guides home.
@jaredlockhart
jaredlockhart marked this pull request as ready for review July 27, 2026 19:14

@yashikakhurana yashikakhurana left a comment

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.

Yes very helpful, thank you @jaredlockhart

@jaredlockhart
jaredlockhart merged commit 6b34f67 into main Jul 28, 2026
2 checks passed
@jaredlockhart
jaredlockhart deleted the enrollment-lifecycle-doc branch July 28, 2026 20:41
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.

2 participants