Enhance experiment designing documentation#781
Open
jaredlockhart wants to merge 1 commit intoenhance-rollouts-docsfrom
Open
Enhance experiment designing documentation#781jaredlockhart wants to merge 1 commit intoenhance-rollouts-docsfrom
jaredlockhart wants to merge 1 commit intoenhance-rollouts-docsfrom
Conversation
2f3d167 to
48920a0
Compare
Because * The designing experiments article was very brief (~25 lines) with minimal guidance beyond linking to external resources * It lacked consistency with the recently enhanced Rollouts and Firefox Labs articles * There was no guidance on when to use an experiment vs alternatives This commit * Expands the article with clear sections matching the Rollouts and Labs structure: when to use, when not to use, lifecycle, key concepts, and step-by-step design process * Adds cross-links to Rollouts and Firefox Labs as alternatives * Adds experiment lifecycle documentation (Design → Configure → Review → Enrolling → Observation → Analysis → Complete) * Adds key concepts section covering branches, enrollment, observation, and sizing * Moves the workflow diagram to the end and links to the live Miro board * Adds a "Next steps" link to the Configuring page fixes #780 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
48920a0 to
52db477
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Warning
This PR is based on #779 (Rollouts enhancement), which is based on #777 (Firefox Labs docs). Review those PRs first — this one only adds the experiments article changes on top.
Summary
Expands the experiment designing article from ~25 lines to a comprehensive guide, drawing on the experiment brief template to walk users through the full design process. File renamed from
designing.mdtoexperiments.mdto match its sidebar label.Changes
Restructured into clear phases:
New content from the experiment brief template:
Housekeeping:
designing.md→experiments.mddesigning→experimentsfixes #780
🤖 Generated with Claude Code