Voting Infrastructure SOP

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
m (Creating the election)
(redirect page to new infra-docs)
 
(2 intermediate revisions by one user not shown)
Line 2: Line 2:
 
{{shortcut|ISOP:Voting}}
 
{{shortcut|ISOP:Voting}}
  
The live voting instance can be found at [https://admin.fedoraproject.org/voting https://admin.fedoraproject.org/voting] and the staging instance at [https://admin.stg.fedoraproject.org/voting/ https://admin.stg.fedoraproject.org/voting/]
 
  
The code base can be found at [http://git.fedorahosted.org/git/?p=elections.git http://git.fedorahosted.org/git/?p=elections.git]
+
This SOP has moved to the fedora Infrastructure SOP git repo. Please see the current document at: http://infrastructure.fedoraproject.org/infra/docs/voting.txt
  
== Contact Information ==
+
For changes, questions or comments, please contact anyone in the Fedora Infrastructure team.
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.
 
 
{|
 
!align="left"|Field
 
!align="left"|Description
 
|-
 
!align="left"|Alias
 
|A short name for the election, make sure you set this
 
|-
 
!align="left"|URL
 
|A URL pointing to more information about the election
 
|-
 
!align="left"|Start Date
 
| The Start of the elections (UTC)
 
|-
 
!align="left"|End Date
 
| The Close of the elections (UTC)
 
|-
 
!align="left"|Seats Elected
 
| How many seats will be elected
 
|-
 
!align="left"|Embargoed
 
| If this is set then it will require manual intervention to release the results of the election
 
|-
 
!align="left"|Allow Nominations
 
| Permits nomination of candidates ('''Not in use''')
 
|-
 
!align="left"|Until When
 
| Closing date for nominations ('''Not in use''')
 
|-
 
!align="left"|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> ;
 
  
 
[[Category:Infrastructure SOPs]]
 
[[Category:Infrastructure SOPs]]

Latest revision as of 19:19, 19 December 2011

Infrastructure InfrastructureTeamN1.png
Shortcut:
ISOP:Voting


This SOP has moved to the fedora Infrastructure SOP git repo. Please see the current document at: http://infrastructure.fedoraproject.org/infra/docs/voting.txt

For changes, questions or comments, please contact anyone in the Fedora Infrastructure team.