election_title: Ann, Bob, Cal - the canonical leading example (single-winner STAR)

bv_test_id: BV2187
bv_election_id: qrw6wb
bv_results_url: https://bettervoting.com/qrw6wb/results

scenario_description: |-
  THE repo's leading example - the exact election shown in the root README, the
  YAML authoring template, and "Why YAML test cases". One file, three voters,
  three candidates: the smallest STAR election where both rounds do visible,
  different work. If a page needs "a STAR election" and nothing scenario-specific,
  it should show THIS one (see 07_Concepts/tips/TIPS_canonical_elections.md).

  Live results: https://bettervoting.com/qrw6wb/results (BetterVoting election
  qrw6wb, Test ID BV2187; write-ins disabled - the candidate list is locked).

  What each ballot teaches:
  - Voter 1 (5,4,0): likes BOTH Ann (5) and Bob (4) - no vote-splitting fear.
    In the runoff her ballot is one full vote for Ann (5 > 4): a near-tie in
    scores is still a whole vote in the runoff.
  - Voter 2 (3,5,2): a Bob fan who honestly scores the others too.
  - Voter 3 (0,3,5): loves Cal, rates Bob a lukewarm 3 - and that honest 3 is
    exactly what makes Bob everyone's acceptable choice.

  The count: Scoring Round totals Bob 12, Ann 8, Cal 7 -> finalists Bob & Ann.
  Automatic Runoff: Bob is preferred on 2 ballots, Ann on 1 -> Bob wins 2-1.
  Bob leads the scores AND wins the runoff - deliberately no twist, so the
  PROCEDURE is the whole lesson. (Bob is also the Condorcet winner.)

  CANONICAL = FROZEN: never edit these ballots. A lesson needing different
  ballots gets a new scenario with a new cast of names.

voting_method: STAR   # STAR Voting - Single-winner
num_winners: 1
ballots: |-
  Ann,Bob,Cal
  5,4,0
  3,5,2
  0,3,5

expected_winners:
  - Bob

# file: bv2187_qrw6wb_ann-bob-cal.yaml