docs: add a README

We're closing up on the private alpha release!
master
Dominique Merle 4 years ago
parent 1b0b22a579
commit 89f73920d6

@ -0,0 +1,75 @@
# Majority Judgment Polling (for Streamers)
Make a majority judgment poll in a few seconds _(as low as 0.5s, by hitting `Enter` twice)_, and let your community vote on it through one of the _providers_, like your Twitch Chat, using commands such as `A2 B1 C4`.
## Overview
This is a distributable project made with Godot Game Engine, and there is no server-side to this application.
All the data is held by the streamer, on their computer,
whether they're using a binary or the web application on _itch.io_.
By design, the ballots are open, which may be unsuitable for politics, but it will allow us to enable delegation features, and we find that exciting!
Perhaps there is a way to close the ballots (using whispers, a twitch js overlay or some other trick).
## Disclaimer
The project is in a **PRIVATE ALPHA** stage.
We're looking for streamers willing to test it out and help us improve the software by making it crash in a number of interesting ways.
Open an issue in our tracker and help us !
Join us on Discord : https://discord.gg/dDnfWD
## Chat Commands
Vote Chat Commands are in the form:
```
<CandidateLetter><GradeValue>
```
Letters start with `A` (duh), and each candidate gets attributed a different letter when they are added to the poll.
Grades start at `0`, and their meaning is as follows:
0. TO REJECT
1. POOR
2. PASSABLE
3. GOOD
4. VERY GOOD
5. EXCELLENT
This is an example of meaning for 6 grades.
We may support different gradings in the future.
## Add a new provider
1. Extend `MajorityJudgmentAbstractProvider`.
2. Register it in `App.gd`.
3. Add its toggle to the `SettingsForm` scene.
## Missing Features
- Delegation (yay!)
- Use the Poll Title :p
- More providers (Youtube live, IRC, CSV file, etc.)
- Option to align with bottom (perhaps tricky, perhaps not)
- Option to change the background color
- Save/Load polls (only the GUI left to do)
- Resilience to scale (Poll tallier may be vastly improved)
- …
## LICENSE
_This is libre software._
MIT
Loading…
Cancel
Save