How to use Voter.js
Quick start for most TWOWs
- Open the Google Sheet (or similar) for the voter screen of what TWOW you want to vote on.
- If you don't have a Google Sheet, create a list of responses in a text editor, one line per response, with letters separated from responses with tabs or one space.
- Copy the letters and responses (not word counts) by selecting them all and pressing Ctrl-C (Cmd-C on Macs; on mobile, hold down and press Copy)
- Open Voter.js and paste into the big box.
- If the screen you are voting on contains your response(s), then write those letters into the box.
- Press Go.
- Vote! The voting screen is fairly self explanatory, just keep clicking the best responses until you reach the end. For details, see below.
- Before the end, you have an opportunity to rearrange any responses which you may have voted up or down by accident.
- Copy the voting string from the textbox at the bottom and DM it to your host with the keyword!
What is this?
Voter.js is a web tool made by me (figgyc#0168 on Discord) that is designed to help you conveniently and accurately rank lines of text from best to worst. The main purpose is
for online competitions known as miniTWOWs, in which the goal is to create the best ten-word sentence responding to a given prompt,
which you probably knew already. Many of these rounds can contain hundreds of responses and it is a nightmare to manually rate and compare thousands of times by hand, however
it is beneficial to do so (supervote) to improve the accuracy of results. Therefore automated tools, like Voter.js and voter.exe before it, were created to sort a list of responses
based on simple 1v1 comparisons.
What do all the buttons do?
- Your response letters: Usually in a TWOW, you vote on a list containing your own response, so typing those letters here results in the program automatically ranking those above all the others. If TWOW mode is disabled, use line numbers here instead of letters. If you have more than one response (eg DRPs), separate them with commas. The order in which you type them is not considered; if you care, rearrange them at the end.
- Enable tier listing/ranking: This mode makes sorting significantly faster on large screens. The way it works is that you can sort responses into tiers / ratings of your choosing before going to the main sorting screen. The comparing tool automatically assumes any response in a greater tier is better than a lower tier so it saves you a lot of time. You can leave responses unsorted and they are excluded from tier-based sorting.
- TWOW mode: disabling this allows you to rank any list, even if it does not have a letter-response mapping. You could use Voter.js to order anything, such as a tier list of characters!
- Show word count: Of course for TWOWs it is important to know if a response is 10 words, so a rudimentary word count is provided. No algorithm is perfect: always double check before you downvote.
- Smart colors: Rereading responses over and over can be cumbersome, so it can be useful to know at a glance how much you like or dislike a response. Smart colours is similar to voter.exe, in that good responses are in green, bad responses are in red, and middling responses are in yellow.
- Save and load: Voting can take a while so if you want you can save your progress, close the page and return later. An autosave is made for you, or if you want to vote on multiple TWOWs at once then you can set a name to save multiple. Use the Load savestate button on the main page to get back to where you were. Note: This is always stored on your computer using localStorage, I don't know what you vote for, but bear in mind if you clear browser data these will disappear, and they don't move between devices.
- Use legacy sorting algorithm: As of October 23rd, 2020, Voter.js switched from your browser's native sort to merge sort. Merge sort is better, but if you prefer the old way you can turn it on with this. Note: I don't recommend enabling this, the new algorithm should be faster in all cases, it is just provided if you prefer the way it shows you things.
- Undo: This simply forgets the last comparison you made, useful if you make a mistake.
- Finish now: If a vote is taking too long and you're nearing a deadline, this button will create an approximate finished vote based on your voting so far. Always review the list in detail when you do this! Depending on how early you invoke this, it can lead to wildly inaccurate votes. Use with caution.
- 1 and 2 on your keyboard: That's right, Voter.js has keyboard support now! 1 indicates the top response and 2 the bottom. Simple, but it works.