docs: add a Bloc STAR Voting help page, and link it from the Basic Multi-Winner tip - #1474
docs: add a Bloc STAR Voting help page, and link it from the Basic Multi-Winner tip#1474masiarek wants to merge 5 commits into
Conversation
Bloc STAR is selectable on BetterVoting (STAR + Basic Multi-Winner) but has no help page: the ballot text lives inside paper_ballots.md and nothing explains the count, the tiebreak, or when not to use an at-large method. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
…er tip The Proportional Multi-Winner tip has a Learn More link; the bloc tip had no learn_link and therefore no Learn More at all. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
✅ Deploy Preview for bettervoting ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
|
No actionable comments were generated in the recent review. 🎉 ℹ️ Recent review info⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: CHILL Plan: Pro Plus Run ID: 📒 Files selected for processing (2)
📝 WalkthroughSummary by CodeRabbit
WalkthroughSummary Poem
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✨ Finishing Touches🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
The page claimed a runoff percentage is a share of the voters who expressed a preference between the two finalists. It is the other way round: the bar labels divide by every ballot cast, and it is the dashed majority threshold that divides by the preference-expressing subset (ResultsBarChart.tsx:85 drops the last row -- Equal Support or exhausted -- from the marker's denominator only). That mismatch is the subject of Equal-Vote#1471; this page should not state the opposite of it. Also names the on-screen category, "Equal Support" (en.yaml:304), so a reader can find it on the results chart. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The circulated paper-ballot text says "the candidate with the most votes is elected"; technical specifications v1.3 §3.d says "the finalist preferred by the most voters wins". The second closes the stars-are-votes reading that the first invites, so the page now carries both and says which to print. §3.e licenses the paraphrase, so neither is off-spec. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
Pushed a third commit after actually reading the specification rather than the campaign pages.
The first row is the one worth caring about. "The candidate with the most votes" invites a voter to read stars as votes and conclude the top scorer is elected — exactly what Bloc STAR doesn't guarantee, and the thing this page has a whole section warning about. "The finalist preferred by the most voters" names the field and the currency and closes it. §3.e permits paraphrase "as long as they are presented with the meaning unchanged", so the circulated version isn't off-spec — but that clause is where the meaning is arguably not unchanged. The page now prints both and says to use the specification's on a real ballot. Two other things from the same read, for whoever maintains the paper-ballot doc: §3.a makes printing the instructions and the method explanation mandatory, not advisory; and §2.c defines Bloc as single-winner STAR "with an additional Automatic Runoff round conducted for each seat" — terse, but correct, because the removal step leaves every remaining candidate's score untouched, so only the runoff genuinely repeats. Happy to make the same correction in |
My previous commit wrote the whole file from a local copy taken before fe6c177, so it silently reverted that fix and put the wrong claim back on the page. The correction stands as written: the bar labels divide by every ballot cast, and only the majority-threshold marker drops the Equal Support row (ResultsBarChart.tsx:85). Restored verbatim; the specification-wording section from the reverting commit is kept. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
|
Correction on my side: my previous commit wrote the whole file from a copy taken before fe6c177, so it reverted that denominator fix and put the wrong claim back on the page for about ten minutes. Restored verbatim in 745a4a3 — the bar labels divide by every ballot cast, only the majority-threshold marker drops the Equal Support row. The specification-wording section is unaffected. |
1 participant
Description
BetterVoting can already run Bloc STAR — STAR + Basic Multi-Winner — but there's nothing in the docs that explains it.
docs/help/has no page for any voting method's multi-winner behaviour, the ballot text exists only insidepaper_ballots.md,faq.mdnever mentions multi-winner, andtips.bloc_multi_winneris the only method tip inen.yamlwith nolearn_link, so its tooltip renders without a Learn More at all (tips.proportional_multi_winnerhas one, to equal.vote/pr).Two commits:
1.
docs/help/bloc_star.md(new, nav_order 9). Covers:2.
en.yaml— one line,learn_linkontips.bloc_multi_winnerpointing at the new page.styles.tsxrenders it as the standard "Learn More" anchor, so no component change is needed; this is the same move as #1465. Drop this commit if you'd rather land the page on its own first.Notes:
starvote(method=bloc, seats=2), winners A then C, seat 2 decided by the higher-score tiebreaker exactly asdocs/help/ties.mdspecifies. BetterVoting's ladder gives the same answer.es/pl/pt-BRcarry notips:block, so this creates no translator obligation.https://docs.bettervoting.com/help/bloc_star.html.Screenshots / Videos (frontend only)
No visual change beyond the tooltip gaining a "Learn More" anchor, in the same position and style as the Proportional Multi-Winner tip already has.
Related Issues
Related to #1086 — it asks for the results-page help link to stop pointing at "How STAR voting works" for a Bloc race, and suggests electowiki as the target. This gives BetterVoting a first-party page to point at instead, but doesn't touch the results page, so I'm leaving #1086 open.
🤖 Generated with Claude Code