From f07952719a64905acf2face8ed2989a19edbcd9c Mon Sep 17 00:00:00 2001 From: "Robin H. Johnson" Date: Sat, 25 May 2024 10:02:48 -0700 Subject: README: improve details about infra steps Signed-off-by: Robin H. Johnson --- README.md | 25 +++++++++++++++++++------ 1 file changed, 19 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 856b1f9..9cd9ec1 100644 --- a/README.md +++ b/README.md @@ -69,12 +69,14 @@ The URLs may link to either of two repos for the data: ------------------- The regular way is to login to `dev.gentoo.org` and run `votify`. -2.2. Handle special ballots: --------------------------- +2.2. Handle special ballots (optional) +-------------------------------------- +This step requires an infra contact. + Some elections may have voters who cast ballots by irregular means: they should be accepted only via GPG-signed email to the election officials, who should agree that the signature is valid and matches a key that was already on -a list prior to the election. The infra contact should place the ballot in +a list prior to the election. The infra contact must place the ballot in `dev.gentoo.org:/home/$membername/.ballot-${election_name}-submitted` The elections mechanisms make no provision for truely secret ballot: election @@ -90,10 +92,15 @@ Trustees. Just wait. `election-stats-count` runs every 30 minutes by cronjob, and prints status files into the home directories of election officials: `voter-turnout-${election_name}`. + +4. Close of election: +--------------------- +This is the only step where the infra contact is absolutely required. + 4.a. Automated "Close of election" ---------------------------------- -Before the end of the election, run the script to schedule automated -`countify --collect`: +Before the end of the election, the infra contact must run the script to schedule +automated `countify --collect`: ``` $ sudo su # cd /etc/elections @@ -106,9 +113,15 @@ The job can be verified with: # at -c $JOB_ID ``` +If the election closing time is modified, the old job MUST be deleted before +the automated collection executes. +``` +# atq +# atrm $JOB_ID +``` + 4.b. Manual "Close of election" ------------------------------- -This is the only step where the infra contact is absolutely required. The infra contact must run `countify --collect ${election_name}` as root, which will write the master ballot & confirmation stub file to all officials: ``` -- cgit v1.2.3-65-gdbad