Skip to content

docs: Update experiment lifecycle terminology (stop → end, ship → end, reset → reset analysis)#15144

Merged
mp-hog merged 6 commits intomasterfrom
docs-writer-ai-update-2026-02-19T12-09-05-298Z
Mar 6, 2026
Merged

docs: Update experiment lifecycle terminology (stop → end, ship → end, reset → reset analysis)#15144
mp-hog merged 6 commits intomasterfrom
docs-writer-ai-update-2026-02-19T12-09-05-298Z

Conversation

@inkeep
Copy link
Copy Markdown
Contributor

@inkeep inkeep Bot commented Feb 19, 2026

Changes

Updates documentation to reflect the experiment lifecycle terminology changes from PostHog/posthog#48407.

Summary of UI changes

  • "Ship a variant" → "End experiment" – The shipping action is now called "End experiment" with "variant to keep" phrasing
  • "Stop experiment" removed – The stop action has been removed entirely; "End experiment" is now the single action to conclude an experiment
  • "Reset experiment" → "Reset analysis" – Clarifies that resetting only affects analysis data, not the feature flag or variant rollout

Files updated

  • contents/docs/experiments/analyzing-results.mdx – Updated "Shipping a variant" section to "Ending an experiment", replaced "Stopping an experiment" with "Resetting analysis", updated comparison table to remove "Stopping" row and rename "Shipping" to "Ending"
  • contents/docs/experiments/start-here.mdx – Updated "Ship a variant" button reference to "End experiment"
  • contents/docs/experiments/best-practices.mdx – Updated launch checklist from "Ship winning variant code" to "End experiment and deploy winning variant code"
  • contents/tutorials/abn-testing.md – Updated "Rolling out the winning variant" section to use "End experiment" button instead of the removed "stop" button

inkeep Bot added 4 commits February 19, 2026 12:10
- Rename "Shipping a variant" to "Ending an experiment" with "variant to keep" phrasing
- Replace "Stopping an experiment" with "Resetting analysis"
- Remove reference to manual stop action (removed in PR #48407)
- Update comparison table with new action names
Reflects UI changes from PostHog/posthog#48407 which renamed the
shipping action to 'End experiment' with 'variant to keep' phrasing.
Reflects PR #48407 which renamed "Ship a variant" to "End experiment" in the experiments UI.
…iment" action

Replace references to "stop" button and manual feature flag rollout with the
new "End experiment" button workflow per PR #48407.
@inkeep inkeep Bot requested a review from mp-hog February 19, 2026 12:12
@vercel
Copy link
Copy Markdown

vercel Bot commented Feb 19, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
posthog Ready Ready Preview Feb 19, 2026 0:36am

Request Review

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Feb 19, 2026

Vale prose linter → found 0 errors, 29 warnings, 1 suggestions in your markdown

Full report → Copy the linter results into an LLM to batch-fix issues.

Linter being weird? Update the rules!

contents/docs/experiments/analyzing-results.mdx — 0 errors, 6 warnings, 1 suggestions
Line Severity Message Rule
72:93 warning 'frequentist' is a possible misspelling. PostHogBase.Spelling
89:48 warning 'Frequentist' is a possible misspelling. PostHogBase.Spelling
157:29 warning Capitalize 'Product Analytics' for PostHog's product. Use 'Product analytics' for the general industry concept. PostHogBase.ProductNames
160:15 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
168:30 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
202:11 warning Capitalize 'Experimentation' for PostHog's product. Use 'experimentation' for the general industry concept. PostHogBase.ProductNames
208:26 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
contents/docs/experiments/best-practices.mdx — 0 errors, 4 warnings, 0 suggestions
Line Severity Message Rule
65:84 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
67:219 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
71:50 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
97:213 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
contents/docs/experiments/start-here.mdx — 0 errors, 17 warnings, 0 suggestions
Line Severity Message Rule
2:29 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
25:71 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
41:68 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
53:62 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
67:78 warning Avoid trivializing words. 'Simply' can sound dismissive to the reader. PostHogDocs.Trivializers
143:11 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
145:1 warning '** Session replay' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
145:70 warning Capitalize 'Session Replay' for PostHog's product. Use 'Session replay' for the general industry concept. PostHogBase.ProductNames
148:1 warning '** Feature flags' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
148:68 warning Capitalize 'Feature Flags' for PostHog's product. Use 'Feature flags' for the general industry concept. PostHogBase.ProductNames
149:67 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
151:1 warning '** Advanced experimentation' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
151:71 warning Capitalize 'Experimentation' for PostHog's product. Use 'experimentation' for the general industry concept. PostHogBase.ProductNames
152:29 warning 'frequentist' is a possible misspelling. PostHogBase.Spelling
161:13 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
163:31 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
176:53 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
contents/tutorials/abn-testing.md — 0 errors, 2 warnings, 0 suggestions
Line Severity Message Rule
19:25 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
104:47 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Mar 6, 2026

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Mar 06, 2026 04:00PM

@mp-hog mp-hog enabled auto-merge (squash) March 6, 2026 15:49
@mp-hog mp-hog merged commit 3a291d2 into master Mar 6, 2026
16 checks passed
@mp-hog mp-hog deleted the docs-writer-ai-update-2026-02-19T12-09-05-298Z branch March 6, 2026 16:00
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.

1 participant