From Fedora Project Wiki

mNo edit summary
Line 28: Line 28:


{|
{|
!Field
!align="left"|Field
!Description
!align="left"|Description
|-
|-
!Alias
!align="left"|Alias
|A short name for the election, make sure you set this  
|A short name for the election, make sure you set this  
|-
|-
!URL:
!align="left"|URL:
|A URL pointing to more information about the election
|A URL pointing to more information about the election
|-
|-
!Start Date:
!align="left"|Start Date:
| The Start of the elections (UTC)
| The Start of the elections (UTC)
|-
|-
!End Date:
!align="left"|End Date:
| The Close of the elections (UTC)
| The Close of the elections (UTC)
|-
|-
!Seats Elected:
!align="left"|Seats Elected:
| How many seats will be elected
| How many seats will be elected
|-
|-
!Embargoed?
!align="left"|Embargoed?
| If this is set then it will require manual intervention to release the results of the election
| If this is set then it will require manual intervention to release the results of the election
|-
|-
!Allow Nominations?
!align="left"|Allow Nominations?
| Permits nomination of candidates ('''Not in use''')
| Permits nomination of candidates ('''Not in use''')
|-
|-
!Until When?
!align="left"|Until When?
| Closing date for nominations ('''Not in use''')
| Closing date for nominations ('''Not in use''')
|-
|-
!Use FAS?
!align="left"|Use FAS?
| If set, then Candidates are supposed to have an entry in FAS,  
| If set, then Candidates are supposed to have an entry in FAS,  
for display purposes FAS user names are converted into Real Names
for display purposes FAS user names are converted into Real Names

Revision as of 09:49, 28 April 2010

Shortcut:
ISOP:Voting

The live voting instance can be found at https://admin.fedoraproject.org/voting and the staging instance at https://admin.stg.fedoraproject.org/voting/

The code base can be found at http://git.fedorahosted.org/git/?p=elections.git

Contact Information

Owner: Fedora Infrastructure Team

Contact: #fedora-admin, elections

Location: PHX

Servers: app servers, bapp01, db02

Purpose: Provides a system for voting on Fedora matters

Creating a new election

Creating the election

Go to voting/admin/newe and fill in the form.

The "usefas" option results in candidate names being looked up as FAS usernames an displayed as their real name.

An alias should be added when creating a new election as this is used in the link on the page of listed elections on the frontpage.

Field Description
Alias A short name for the election, make sure you set this
URL: A URL pointing to more information about the election
Start Date: The Start of the elections (UTC)
End Date: The Close of the elections (UTC)
Seats Elected: How many seats will be elected
Embargoed? If this is set then it will require manual intervention to release the results of the election
Allow Nominations? Permits nomination of candidates (Not in use)
Until When? Closing date for nominations (Not in use)
Use FAS? If set, then Candidates are supposed to have an entry in FAS,

for display purposes FAS user names are converted into Real Names

Adding Candidates

A list of all elections (and their IDs) can be found at voting/admin/list_elections

Go to voting/admin/newc and fill in the form, using the id found through list_elections.

This will add extra candidates to the available list.

Who can vote

Before anyone can vote you need to manually alter the database to say which groups are permitted to vote in the election.

 insert into legalvoters(election_id, group_name) values(<ELECTION_ID>, '<GROUPNAME>');

There are 2 magic GROUPNAME strings that can be used

  • anycla - (any FAS group not beginning cla_)
  • anyany - (any FAS group)

Modifying an Election

Changing the details of an Election

This currently requires direct editing of the database. (Elections table)

Removing a candidate

This currently requires direct editing of the database. (Candidates table)

Releasing the results of an embargoed election

This currently requires direct editing of the database. (Elections table)

 update elections set embargoed=0 where id = <ELECTION_ID> ;