RepWatchr logoRepWatchr

Vote-record scorecard • method v1

Show your work, or do not show a grade.

Every number on a RepWatchr scorecard is arithmetic over rows printed beneath it on the category page. No secret model, no hand-typed grade, no adjustment anyone has to take on faith. This page is the whole calculation.

category score = weight of aligned votes ÷ weight of votes cast × 100
overall = Σ(category score × category weight) ÷ Σ(category weight of scored categories)

Step by step

Six steps from a roll call to a letter.

Run them in order on any scorecard on this site and you will get the number the page shows.

01

The vote has to exist in a reviewed bill file

Before a vote can move anything, the bill it belongs to has to be in the bill record with a public source link, and that file has to show this official casting that exact vote. A vote typed onto a scorecard that the bill file does not corroborate is not scored low. It stops the whole scorecard.

02

Alignment is computed, never read off the file

Each bill carries a declared district position, and the gate refuses any card whose copy of that position disagrees with the reviewed bill. A vote is aligned when the official's recorded vote matches it. The stored `aligned` flag on a row is for display only; the arithmetic re-derives it, so neither a mistyped flag nor a mistyped position can move anyone's score.

03

An absence is not a wrong vote

Only yea and nay are scored here. Absent, abstain, and not-applicable rows are counted and shown, but they are removed from both sides of the division instead of being converted into a zero. Attendance is graded separately, under the performance grade — it is simply not what this number measures.

04

Every vote carries its own weight, 1 to 10

Weight is how much the bill actually decides, set when the bill is reviewed. A weight-10 bill moves a category ten times as far as a weight-1 bill, so a long list of trivial votes cannot bury one that mattered. A row whose weight is missing or outside 1-10 is not quietly repaired to something usable — it withholds the card.

05

The category score is weighted alignment

Add the weights of the aligned votes. Divide by the weight of every vote the official actually cast in that category. That percentage is the category score. A category with no reviewed votes has no score at all, and the page says so rather than printing a zero.

06

The overall number averages the categories by weight

Category scores are averaged using the declared category weights, over the categories that have votes only. Empty categories drop out of both the top and the bottom of the division, so a thin record reads as partial, not bad.

Worked example

Two votes, and why the weights decide it.

A representative votes with the district on a bill reviewed at weight 10, and against it on a bill reviewed at weight 1.

BillDistrict positionVote castWeightCounts toward
Eminent domain reformyeayea10aligned · 10
Appraisal notice deadlineyeanay1not aligned · 0
Pipeline easement disclosureyeaabsent—not scored, shown on the profile

The five categories

Five issues, 100% of weight between them.

These weights are read from the published issue file, not typed onto this page, so the two cannot disagree.

Letter scale

A strict scale, on purpose.

A public official does not get a friendly letter for a barely passing record. 80 reads as a C here. These bands are printed straight out of the grading function.

A+

98–100

A

95–97

A-

90–94

B

85–89

C

80–84

D

70–79

F

0–69

This scale grades the vote record only. The performance grade uses the conventional A/B/C/D scale because it measures something else entirely, and community sentiment uses a third. They are documented separately because they disagree on purpose.

Publication gate

What is actually published right now.

An empty scorecard table is not a clean record. It means nothing has cleared this gate yet, and the counts below say so out loud.

Scorecards on file

6

drafted from reviewed vote rows

Published

0

every vote corroborated by its bill file

Withheld

6

not shown anywhere on the site

6

Held for source review

The source desk has not signed the card off. Nothing further is asserted about its rows: the gate stops here, before any bill record is examined, so a card counted in this row may or may not have corroborated votes.

0

No votes on the card

There is a card but nothing on it. A card with no votes is never published as a zero.

0

No scoreable vote

Every row is an absence, an abstention, or not applicable. Nothing there can produce a percentage, so the card is withheld rather than published as a zero that reads like an F.

0

Invalid vote weight

A row's weight is missing, not a whole number, or outside 1 to 10. Clamping it would invent a weight the reviewer never set and move the grade, so the card is withheld instead.

0

Duplicate row

The same bill appears twice in one category. Both copies would corroborate against the single real roll call and then be counted twice by the weighted mean.

0

Row filed under the wrong issue

A row's own category does not match the category it is filed under, so it would score against the wrong issue and change both that issue's number and the overall grade.

0

Vote not corroborated

At least one vote on the card does not match the published bill file for that official. One mismatch withholds the entire scorecard, not just the row.

0

Position not corroborated

The district position on a row does not match the reviewed bill. Alignment is the vote measured against that position, so an uncorroborated position could invert a score exactly as a wrong vote would.

66vote rows are drafted across those cards. They are kept in source control so the work is reviewable, and they are withheld from every public page until the gate clears. Read an empty table as “not checked yet,” never as an endorsement.

What this number is not

Three things this score will never be.

Keeping these out is what makes the number worth anything.

Not a party score

A yea is not scored as morally right and a nay is not scored as morally wrong. The comparison is to a declared district position printed beside the vote, and you can disagree with that position in public on the profile.

Not the performance grade

The performance grade measures documented execution of the job — attendance, effectiveness, ethics findings, transparency duties. Policy direction never touches it, and this score never feeds it.

Not a popularity reading

Community responses are a self-selected signal shown separately and labeled as such. They are not a poll, not an endorsement, and not an input to any calculation on this page.

Found a vote recorded wrong, a weight you would argue with, or a bill with no source link? That is the useful kind of fight. Send it and the calculation changes in public.

Submit a source or correction