From 44a28071364e2755b265871b6953a57c68b46c93 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 15 May 2026 22:05:03 +0000 Subject: [PATCH] Fix broken experiments documentation links Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com> --- docs/src/content/docs/practices/experiments-specification.md | 2 +- docs/src/content/docs/reference/artifacts.md | 2 +- docs/src/content/docs/reference/forecast-specification.md | 4 ++-- docs/src/content/docs/reference/glossary.md | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/src/content/docs/practices/experiments-specification.md b/docs/src/content/docs/practices/experiments-specification.md index 64f99c0b8a9..7138efe91f0 100644 --- a/docs/src/content/docs/practices/experiments-specification.md +++ b/docs/src/content/docs/practices/experiments-specification.md @@ -9,7 +9,7 @@ sidebar: **Version**: 1.0.0 **Status**: Draft -**Latest Version**: [experiments-specification](/gh-aw/reference/experiments-specification/) +**Latest Version**: [experiments-specification](/gh-aw/practices/experiments-specification/) **Editors**: gh-aw maintainers --- diff --git a/docs/src/content/docs/reference/artifacts.md b/docs/src/content/docs/reference/artifacts.md index c809bd7d906..262cb97f5b7 100644 --- a/docs/src/content/docs/reference/artifacts.md +++ b/docs/src/content/docs/reference/artifacts.md @@ -185,7 +185,7 @@ The `🧪 A/B Experiments` section of the audit report shows the variant chosen • style = concise (cumulative: concise:5, detailed:4) ``` -See [A/B Experiments](/gh-aw/guides/experiments/) for how to declare experiments in workflow frontmatter. +See [A/B Experiments](/gh-aw/practices/experiments/) for how to declare experiments in workflow frontmatter. ## Naming Compatibility diff --git a/docs/src/content/docs/reference/forecast-specification.md b/docs/src/content/docs/reference/forecast-specification.md index a4f8c5d979e..1769f36bc3e 100644 --- a/docs/src/content/docs/reference/forecast-specification.md +++ b/docs/src/content/docs/reference/forecast-specification.md @@ -83,7 +83,7 @@ This specification does NOT cover: - The Effective Tokens (ET) computation algorithm (defined in the [Effective Tokens Specification](/gh-aw/reference/effective-tokens-specification/)) - The `aw_info.json` artifact schema -- A/B experiment frontmatter schema (defined in the [A/B Experiments Specification](/gh-aw/reference/experiments-specification/)) +- A/B experiment frontmatter schema (defined in the [A/B Experiments Specification](/gh-aw/practices/experiments-specification/)) - Billing, pricing, or financial modeling beyond token projections - Streaming or real-time token consumption reporting @@ -974,7 +974,7 @@ For orchestrator workflows that primarily use `workflow_call` or `workflow_dispa - **[RFC 2119]** Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. - **[RFC 3339]** Klyne, G. and Newman, C., "Date and Time on the Internet: Timestamps", RFC 3339, July 2002. - **[ET-SPEC]** GitHub Agentic Workflows Team, "Effective Tokens Specification". [effective-tokens-specification](/gh-aw/reference/effective-tokens-specification/) -- **[EXP-SPEC]** GitHub Agentic Workflows Team, "A/B Experiments Specification". [experiments-specification](/gh-aw/reference/experiments-specification/) +- **[EXP-SPEC]** GitHub Agentic Workflows Team, "A/B Experiments Specification". [experiments-specification](/gh-aw/practices/experiments-specification/) ### Informative References diff --git a/docs/src/content/docs/reference/glossary.md b/docs/src/content/docs/reference/glossary.md index 0461c35fe74..b3fb6c7c803 100644 --- a/docs/src/content/docs/reference/glossary.md +++ b/docs/src/content/docs/reference/glossary.md @@ -341,7 +341,7 @@ See [Engines Reference](/gh-aw/reference/engines/). A frontmatter section that enables A/B testing of workflow prompt variants across successive runs. Each key in the `experiments:` map names an experiment; the value is either a bare array of variant strings or a rich object with additional fields (`variants`, `description`, `hypothesis`, `metric`, `weight`, `min_samples`, `start_date`, `end_date`). At runtime the activation job selects one variant per experiment using a balanced round-robin counter and exposes the selection as `${{ experiments. }}` for use anywhere in the workflow body. -Experiment state is persisted to dedicated `experiments/` git branches in the workflow repository. Use `gh aw experiments list` and `gh aw experiments analyze` to inspect variant distribution and statistical readiness (chi-square balance test, Bonferroni correction, EXTEND / READY_FOR_ANALYSIS recommendation). See [A/B Experiments](/gh-aw/guides/experiments/) and the [Experiments Specification](/gh-aw/reference/experiments-specification/). +Experiment state is persisted to dedicated `experiments/` git branches in the workflow repository. Use `gh aw experiments list` and `gh aw experiments analyze` to inspect variant distribution and statistical readiness (chi-square balance test, Bonferroni correction, EXTEND / READY_FOR_ANALYSIS recommendation). See [A/B Experiments](/gh-aw/practices/experiments/) and the [Experiments Specification](/gh-aw/practices/experiments-specification/). ```aw wrap experiments: