Skip to content

docs(experiments): plain-language notes and clearer tables - #111

Merged
leo-gan merged 1 commit into
masterfrom
docs-experiments-plain
Aug 17, 2026
Merged

docs(experiments): plain-language notes and clearer tables#111
leo-gan merged 1 commit into
masterfrom
docs-experiments-plain

Conversation

@leo-gan

@leo-gan leo-gan commented Aug 17, 2026

Copy link
Copy Markdown
Owner

Summary

  • New Experiments site page in everyday words: why we ran each test, an example, the trade-off, and the data we timed.
  • All 13 titles and stories rewritten in experiment.yaml (the settings file). The Dashboard reads them automatically.
  • Experiment tables now match the rest of the Dashboard: green/red cells, `15.9 (1.2×)` vs the fastest row, trials, spread (std), 3 significant digits.
  • The old Group / Similar / Close / Time/size front labels are now Vs fastest: Fastest, About the same, A bit slower, Clearly slower, plus Good trade-off. These are not simply Winner / Loser — two libraries can be too close to call.

Validation

  • Analysis tests: 85 passed
  • All 13 `experiment.yaml` files parse
  • Browser (Chrome): story, sample JSON, `3.89 (1×)` / `7.86 (2×)`, trials `92 of 100`, group labels

Notes

  • Compare libraries inside one language.

Rewrite experiment titles and stories in everyday words. Add an Experiments
docs page. Dashboard tables now use the same green/red multipliers as the
rest of the site, rename groups, show trials and spread, and include the
story plus the timed sample.
@leo-gan
leo-gan merged commit 0e79729 into master Aug 17, 2026
1 check passed
@leo-gan
leo-gan deleted the docs-experiments-plain branch August 17, 2026 21:18
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