Atlas / tournament documentation
Disputes
How a competitor questions a recorded result, how the tab desk claims and rules on it, what each outcome records, and what a ruling does not change.
A dispute is a private note in which a competitor asks the tab desk to review the recorded result of one room. The Disputes view of the Ballots screen is where the desk reads each note, compares it with the result on record, claims it so that nobody else rules on it, and records a ruling. It is the Disputes subview under Ballots in the left rail, at /tournaments/{id}/admin/ballots?view=disputes. The older address /admin/disputes opens the same view. The Queue view of Ballots also lists Disputes under the heading Review, with the number of disputes still open.
A ruling is a record of a decision. It does not change a ballot, a result or standings. A result is changed on the Queue view of Ballots, where the desk can enter a correction with a reason. The two steps are separate, so a dispute ruled corrected leaves the old result in place until a correction is saved there.
Who can use it
| Role | What it can do with disputes |
|---|---|
| Competitor | Files one dispute for a room they debated in, after the room is released and decided, and reads the status and the ruling note on their own room page. A competitor does not see the other side's dispute. |
| Platform admin | Reads every dispute, claims, puts back and rules, for any tournament. |
| Organization owner or admin | The same, for every tournament the organization hosts. |
| Tournament admin seat | The same. |
| Tab seat | The same. A tab seat works disputes exactly as an admin seat does. |
| Compliance seat | Cannot open the view. The claim and the ruling both refuse the seat. |
| Coach, judge, observer | Cannot file or read disputes. Only a competitor in the room can file. |
No notice goes out when a dispute is filed or ruled on. The desk learns of a new dispute from the count beside Disputes in the Ballots rail, from the next step list on the Overview, and from the list in this view. A competitor learns of a ruling by opening their room page.
How a competitor files
On the competitor's room page, a tile titled Question this result appears once the room is released and has a recorded result. It explains that the note is private to the competitor and tournament staff.
| Control | What it does | Default or limit |
|---|---|---|
| What should the tab desk review? | The text of the concern. The placeholder reads Describe the specific result issue. | Required, 1 to 2,000 characters. |
| Submit private dispute | Files the dispute. The page then says Your private dispute was sent to the tab desk. | One dispute for each room. After one exists, the form is replaced by its status. |
While a dispute is open or claimed, the tile reads Your dispute is with the tab desk. When a desk member has claimed it, a second line reads Someone at the tab desk is working on it now. After a ruling, the tile shows Dispute followed by the status, the competitor's text and the desk's note.
Statuses and outcomes
| Status | Meaning | How a dispute gets there |
|---|---|---|
| Open | Filed and not claimed. | A competitor files it, or the desk selects Put back in the queue. |
| In progress | A desk member is working on it. | The desk selects I am working this. |
| Resolved | The desk ruled corrected or upheld. | The desk selects Resolve dispute with Corrected ballot or Upheld original result. |
| Dismissed | The desk ruled that the dispute does not stand. | The desk selects Resolve dispute with Dismissed. |
| Outcome | What the desk records | What the screen then shows |
|---|---|---|
| Corrected ballot | The desk found the recorded result wrong. | The comparison reads Corrected ballot accepted, and the standings line reads Standings recompute required. |
| Upheld original result | The desk reviewed the concern and the recorded result stands. | The comparison reads Original submission upheld, and the standings line reads No standings change. |
| Dismissed | The dispute is set aside. | The comparison reads Dispute dismissed, and the standings line reads No standings change. |
Choosing Dismissed always sets the status to Dismissed. The other two outcomes set the status to Resolved. A finished dispute cannot be claimed or ruled on again.
The queue
| Control or text | What it does | Default or limit |
|---|---|---|
| Dispute queue | The heading of the list on the left. One button for each dispute, newest first. | Opens on the dispute named in the address, otherwise the first in the list. |
| Room line | The round and room of the disputed room, with a status word on the right: Open in red, In progress in amber, Resolved or Dismissed in the accent colour. | None. |
| Matchup line | The competitor who filed, then vs, then the opponent. | Truncated when long. |
| Filed date | The short date the dispute was filed, in the tournament's time zone. | None. |
| Empty list | The text No disputes have been raised. In the middle of the view, the heading Dispute queue empty and the line No open disputes. | Shown when none exist. |
| Footnote | A dispute is the only path to changing a submitted ballot. Both versions remain in the record. | The footnote is the screen's own wording. The desk can also correct a recorded ballot directly from the Queue with a reason. |
The comparison
The middle of the view sets the recorded result beside what the dispute asks for. The heading is Comparison, with the room and matchup and the dispute's status.
| Row | As submitted | Claimed or source |
|---|---|---|
| Decision | The side recorded as the winner, shown as aff or neg, or No result. | Awaiting admin review while the dispute is unfinished. After a ruling, Corrected ballot accepted, Original submission upheld, or Dispute dismissed. |
| Standings effect | Original result. | Potential standings change while unfinished. After a ruling, Standings recompute required for a correction, and No standings change otherwise. |
| Reason | Judge record retained. | The competitor's text. |
While a dispute is open or in progress, a warning reads Correcting this dispute may change standings and the break. The original submission will remain retained. The lines under Claimed or source describe the state of the dispute and are not read from a competitor's claimed result. The comparison does not show the ballot itself. To read the ballot, open the room on the Queue and select Peek, or select View as judge.
The resolve panel
| Control or text | What it does | Default or limit |
|---|---|---|
| Resolve | The panel heading, with the room and Filed followed by the date and time in the tournament's zone, for example Monday 19 October at 02:14 EDT. | None. |
| Filed concern | The competitor's text, as filed. | Up to 2,000 characters. |
| I am working this | Marks the dispute In progress, so a second desk member sees that it is taken. | Shown for an open dispute. |
| Put back in the queue | Returns an in progress dispute to Open. | Shown for an in progress dispute. The note beside it says to put it back if nobody is on it. |
| Resolution | A drop down with Corrected ballot, Upheld original result and Dismissed. | Starts on Upheld original result. |
| Typed reason | The note that records what was reviewed and what changed. The placeholder reads Record what was reviewed and what changed. | Required, 1 to 2,000 characters. |
| Resolve dispute | Records the ruling. | Shown for an open or in progress dispute. A dispute that is claimed by another person can still be ruled on. |
| Finished dispute | For a finished dispute the panel shows the outcome, the time of the ruling and the note, or No resolution note recorded. | Read only. |
After a claim the banner reads Dispute taken up. After a put back it reads Dispute put back in the queue. After a ruling it reads Dispute resolved. The view stays on the dispute that was acted on.
What a ruling changes
- The dispute. Its status, outcome, note, the person who ruled and the time are saved, and the competitor sees the status and note on their room page.
- Records. A claim and a put back are each written to Records. A ruling is written with the note as its reason.
- Counts. The open count in the Ballots rail, the next step list on the Overview and the list of things to settle before Finalize all drop by one.
- Not the ballot. The result, the ballots, the room's status and the standings are untouched. A correction is made on the Queue, where the save needs a reason and runs the release check again.
- Not the competitor's notices. No in-app notice or email reports the ruling.
Tasks
Rule on a dispute with no change to the result.
- Open Ballots. Select Disputes in the left column, under Review.
- Select the dispute in the Dispute queue. Read the Filed concern.
- Select I am working this.
- Open the Queue, select the room and read the ballot. Select View as judge for the judge's own sheet.
- Return to Disputes. Leave Resolution on Upheld original result, type the reason in Typed reason, and select Resolve dispute.
Afterward the banner reads Dispute resolved., the dispute reads Resolved, and the comparison reads Original submission upheld.
Rule on a dispute and correct the result.
- Open Ballots, then Disputes, and select the dispute. Select I am working this.
- Open the Queue and select Peek on the room. Change the wrong field, type the reason in Reason for change, and select Save the correction.
- Return to Disputes, set Resolution to Corrected ballot, type the reason and select Resolve dispute.
- Select Recompute standings on the Queue if the standings do not already show the change.
Afterward the dispute reads Resolved with Corrected ballot accepted, the room shows the corrected result, and Records holds both versions.
Dismiss a dispute.
- Open Ballots, then Disputes, and select the dispute.
- Set Resolution to Dismissed, type the reason, and select Resolve dispute.
Afterward the dispute reads Dismissed and the competitor sees the note.
Hand a dispute back.
- Open the dispute that reads In progress.
- Select Put back in the queue.
Afterward the banner reads Dispute put back in the queue. and the dispute reads Open.
Troubleshooting
| Message | What it means | What to do |
|---|---|---|
Add a resolution note in 1 to 2,000 characters. | The typed reason is empty or longer than 2,000 characters. | Write a reason of up to 2,000 characters. |
Choose a valid dispute resolution. | The outcome was not Corrected ballot, Upheld original result or Dismissed. | Choose one of the three. |
Choose a valid dispute status. | The ruling carried a status the screen does not offer. | Reload and try again. |
Dispute resolution is missing its dispute id. | The form lost the dispute. | Reload and select the dispute again. |
Dispute claim is missing its dispute id. | The claim form lost the dispute. | Reload and select the dispute again. |
You do not have admin access to resolve this dispute | The signed in account has no admin or tab seat for this tournament. | Ask a full admin for a seat. |
You do not have admin access to this dispute | The same refusal on a claim or a put back. | Ask a full admin for a seat. |
Dispute not found | The dispute does not exist, or belongs to another tournament. | Reload. |
Dispute not found or already resolved | Another desk member ruled on it first. | Reload and read the ruling. |
This dispute is already finished | A claim or put back was tried on a resolved or dismissed dispute. | None. |
A dispute must be resolved or dismissed, Choose a valid resolution, Dismissed disputes require a dismissed resolution and Resolved disputes cannot use a dismissed resolution | The status and the outcome disagree. The screen sets them together, so these appear only when the form was altered. | Reload and use the controls. |
This tournament is complete and its results are a record. Nothing on it can be changed. | The tournament is finalized. | None. A completed tournament cannot be reopened. |
Describe the result issue in 1 to 2,000 characters. | A competitor sent an empty or overlong concern. It appears on their room page. | Edit the text. |
Only released completed pairings can have a result dispute | A competitor tried to file on a room that is not released or has no result. | Wait for the result. |
You are not a competitor in this pairing | The account filing the dispute holds no entry in the room. | Sign in with the competitor's account. |
You already have an open dispute for this result | The competitor has an open dispute for the room. | Wait for the ruling. |
Dispute resolved., Dispute taken up. and Dispute put back in the queue. | Confirmations. | None. |
Settings that affect this view
No setting changes how disputes work. The view reads the tournament's time zone to print dates, and the Overview and Finalize read the count of unfinished disputes.