[gentoo-commits] proj/elections:master commit in: /

["Robin H. Johnson" <robbat2@gentoo.org>]

commit:     f07952719a64905acf2face8ed2989a19edbcd9c
Author:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
AuthorDate: Sat May 25 17:02:48 2024 +0000
Commit:     Robin H. Johnson <robbat2 <AT> gentoo <DOT> org>
CommitDate: Sat May 25 17:02:48 2024 +0000
URL:        https://gitweb.gentoo.org/proj/elections.git/commit/?id=f0795271

README: improve details about infra steps

Signed-off-by: Robin H. Johnson <robbat2 <AT> gentoo.org>

 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:
 ```