Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
In Kudocracy, Personas (visitors) vote on propositions to express an orientation. Either "agree", "disagree", "protest" (a strong disagreement, to report abuses typically), "blank" or "neutral".
A persona is a visitor with a twitter name. At this point there is no control of who the personas actually are.
On the login page, the 'alias' is some text that will be displayed next to your name. It can be you full name, or a nick name or whatever you want. Please use _ for spaces.
In addition to voting, visitors can create new propositions and attach tags to classify propositions.
To limit abuses, visitors can vote "protest". If there exists more "protest" votes than any other orientation, the involved tag or proposition is filtered out. Note: use the #abuse tag to search for such cases.
Visitors can vote directly or indirectly when they delegate. The delegation is not global, it is for propositions about topics defined using tags. For example: "@peter #environment + #fiscal" would typically delegate to Peter regarding propositions about the fiscal aspect of environmental policies (assuming such propositions are tagged accordingly).
It is possible to override an indirect vote with a direct vote, at any time. It is also possible to change mind at any time on any previous vote.
When a visitor casts a vote, the vote is valid for a certain duration only, one year by default. When that duration is reached, the vote expires and disappear.
When organizing a "ballot", there usually is a limit date and a list of who can vote. This list is the "electorate".
A domain is typically a group, defined by a Twitter profile. The name of the domain is a twitter name.
To create a domain, tag a visitor with the #domain tag in the main domain. Then login using the domain name. In the page about "you" there will be a "security" link.
That link points to a page where Twitter application credentials are specified. Please create the twitter application (http://apps.twitter.com) to create tokens. Use the "read, write & direct message" authorization. then copy the 4 secret informations.
The "public" check box specifies who can enter the domain. When a domain is private, only those followed can enter.
To restrict who can vote (both in public and private domains), please create a "Kudocracy" twitter list.
To let curators change tags (in addition to proposition authors), please create a "Kudocracy_curators" list (Work in Progress).
Twitter command line (CLI)
Members of a domain can send tweets or direct messages to login, vote or delegate. Such tweets simply needs to start with "kudo" or "kudocracy".
Example: "kudo login" => a direct message with a link to login is answered. "kudo agree #some_prop" => cast a vote about a proposition. "kudo delegate @someone #sometag" => set up a delegation.
Note: tweets are public, direct messages are private.
When a comment contains ... the part after ... is displayed only in the page focusing on the proposition.
To provide comments in multiple languages, add i18n en before each section. Please use i18n en for english, i18n fr for french, i18n it for italian, etc. The first section is also the default section, used when there is no section matching the language of a visitor.