How to Create an Election

How to Create an Election

Most voting done is carried out using the cordorcet voting method, which uses ranking to provide a more robust voting methodology. This is used for the election of all sorts of councils and boards, but most notably the Community Council is elected by the Ubuntu Members. This document covers how that method is done.

Basic Setup

  1. Go to the Condorcet Internet Voting Service.
  2. Give the poll a name (e.g. “Ubuntu Community Council election 2017”)
  3. Give the poll a supervisor (e.g. the name of the council/board).
    1, Make the poll supervisor email the mailing list of the council/board.
  4. Time to close should be about 2 weeks out.
  5. Fill out the description, including an HTML link to the wiki/info
    page of the council/board. Give basic info, like how many candidates
    will be selected, how long the term will be, and to remind them to rank
    all candidates in order of preference.
  6. Fill out the candidates, one line each, including an HTML link to
    their wiki/Launchpad (it can accept this in a file).
  7. Fill in an integer describing the number of winning candidates (i.e.
    how many seats are to be filled with the election).
  8. Make sure the poll is private.
  9. Don’t check anything else.
  10. Hit the “Create Poll” button.

Adding Members

  1. Make sure to get the poll email confirmation out of moderation.
  2. Click on the link in the poll confirmation.
  3. Click the “Start Poll” button.
  4. Using lp-election-helper, run lp-election-helper ubuntumembers > members.
  5. At the bottom of the members file is a list of accounts without emails starting with the comment #### Members with no public email address or GPG key #### . Move them to a separate file.
  6. Remove any comments or blank lines from the members file.
  7. Check for any non-emails with grep -E -v "\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,6}\b" members and try to associate those with Launchpad IDs via web search and/or by looking on the Ubuntu keyserver. Otherwise, remove them.
  8. Add the list to the poll (the members file works).
  9. Click the “Add Members” button.
  10. Contact members without emails separately on Launchpad to get an email to send their ballot to.
  11. Add emails discovered as mentioned above.

Finishing Touches

  1. Post to Discourse and the Fridge and perhaps any relevant mailing lists informing members of forthcoming email (especially the fact it’s coming from and how to contact if they don’t get the mail.
  2. Monitor the poll. If everyone has voted or if it is time to end the poll, the “End Poll” button needs to be clicked.