Skip to content

[side-quest] Add side quest: How A/B Experiment Round-Robin Works #2661

Description

@github-actions

Caution

Protected files were modified in this change.
This pull request is in request_review mode and requires explicit human scrutiny before merge.

Protected files: README.md

What was mined

Source file: workshop/23-ab-experiments.md

Side quest extracted: The "Understand how the round-robin works" section — a self-contained mechanism explainer that describes the five steps gh-aw runs on each experiment run (load state, select variant, save state, upload artifact, inject variant), plus a worked prediction table and practice exercise for a third variant.

What changed

  • New file: workshop/side-quest-23-01-ab-round-robin.md — full round-robin mechanism walkthrough with diagram, prediction table, hands-on verification steps, and a checkpoint.
  • Updated: workshop/23-ab-experiments.md — the detailed inline section is replaced with a concise two-sentence summary and an Optional Side Quest callout linking to the new file. The main learning path (set up variants, run, inspect artifacts, analyse results) is fully preserved.
  • Updated: workshop/README.md — new side quest listed in the Optional Side Quests section with a description and branch-from reference to Step 23.

Learner routing

Learners on the main path see a short explanation of round-robin and a clearly optional tip to go deeper. Learners who want to predict assignment order precisely can follow the side quest and return to the main step when done.

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • awmgmcpg

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by 🗺️ Side Quest · 80.9 AIC · ⌖ 6.95 AIC · ⊞ 5.1K ·

  • expires on Aug 16, 2026, 1:55 PM UTC

Note

This was originally intended as a pull request, but the git push operation failed.

Original error: pushSignedCommits: refusing unsigned push for branch 'side-quest-23-ab-round-robin-03ad072774390708': Signed-commit payload violates file-protection policy (request_review): workshop/README.md

Workflow Run: View run details and download bundle artifact

The bundle file is available in the agent artifact in the workflow run linked above.

To create a pull request with the changes:

# Download the artifact from the workflow run
gh run download 31888085485 -n agent -D /tmp/agent-31888085485

# Fetch the bundle into a temporary ref, then update the local branch
git fetch /tmp/agent-31888085485/aw-side-quest-23-ab-round-robin.bundle refs/heads/side-quest-23-ab-round-robin:refs/bundles/create-pr-side-quest-23-ab-round-robin-03ad072774390708-1b29db06
git update-ref refs/heads/side-quest-23-ab-round-robin-03ad072774390708 refs/bundles/create-pr-side-quest-23-ab-round-robin-03ad072774390708-1b29db06
git checkout side-quest-23-ab-round-robin-03ad072774390708
# Ensure the working tree matches the updated branch
git reset --hard
# Remove the temporary bundle ref
git update-ref -d refs/bundles/create-pr-side-quest-23-ab-round-robin-03ad072774390708-1b29db06

# Push the branch to origin
git push origin side-quest-23-ab-round-robin-03ad072774390708

# Create the pull request
gh pr create --title '[side-quest] Add side quest: How A/B Experiment Round-Robin Works' --base main --head side-quest-23-ab-round-robin-03ad072774390708 --repo githubnext/gh-aw-workshop

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions