Skip to content

docs: Expand "Running well powered experiments" with guides beyond variance and methodology#722

Open
bertilhatt wants to merge 1 commit intomainfrom
docs/power-beyond-variance-pages
Open

docs: Expand "Running well powered experiments" with guides beyond variance and methodology#722
bertilhatt wants to merge 1 commit intomainfrom
docs/power-beyond-variance-pages

Conversation

@bertilhatt
Copy link
Copy Markdown
Contributor

Summary

The Running well powered experiments guide was a single page focused on reducing variance (metrics, winsorization, CUPED++) and choosing a statistical paradigm. This change turns it into a small sidebar section and adds four pages for levers that are not "pick a lower-variance metric" or "change the test type": runtime/seasonality, who-and-what you measure, rich covariates for CUPED++, and experiment ambition / tactical vs. strategic measurement.

What changed

  • running-well-powered-experiments/index.md — Same URL as before. Original content kept; added stakeholder-oriented CUPED intuition (large adjustments vs. imbalance); new "Beyond variance reduction and statistical methodology" hub with links to the four new pages; conclusion updated.

  • runtime-seasonality-sample-size.md — Prefer running longer when arms look very different; seasonality/baseline benefits; when time is fixed, point back to variance, covariates, targeting, and ambition.

  • design-targeting-dilution-proximal-metrics.md — Small‑N and talking to users; proximal metrics; targeting/segments; entry points (links to existing entry points guide); higher-conversion proxy steps + link to tactical/strategic page.

  • covariates-for-cuped-plus-plus.md — Assignment and context features (acquisition, geo, weather, time structure, demographics); new users; UI limits and notebook/historical rehearsal note.

  • ambition-tactical-strategic-measurement.md — Bolder ideas, user/non-user research, internal disagreement; tactical A/B vs strategic holdout (search, email capture); links to proximal metrics and runtime.

  • _category_.json — Sidebar category "Running well powered experiments" with the overview doc as the category link.

Links and build

  • Existing anchors such as #handling-outliers-using-winsorization remain on the same URL path.
  • npx docusaurus build completes successfully with these changes.

Turn the single page into a small section: keep variance and statistics
on the overview, and add pages for runtime/seasonality, targeting and
proximal metrics, rich CUPED++ covariates, and ambition/tactical-vs-
strategic measurement. Cross-link entry points and preserve existing URLs
for the main guide.

Made-with: Cursor
@netlify
Copy link
Copy Markdown

netlify bot commented Apr 8, 2026

Deploy Preview for eppo-data-docs ready!

Name Link
🔨 Latest commit 361d247
🔍 Latest deploy log https://app.netlify.com/projects/eppo-data-docs/deploys/69d674f5e7fe500008b2d4da
😎 Deploy Preview https://deploy-preview-722--eppo-data-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

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