aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRobin H. Johnson <robbat2@gentoo.org>2024-05-25 10:02:48 -0700
committerRobin H. Johnson <robbat2@gentoo.org>2024-05-25 10:02:48 -0700
commitf07952719a64905acf2face8ed2989a19edbcd9c (patch)
tree1bd8c3aea93a778e7f140afbb190a4ee5fbb0fc8
parenttrustees-202306: capture casting-voters-trustees-202306 (diff)
downloadelections-f07952719a64905acf2face8ed2989a19edbcd9c.tar.gz
elections-f07952719a64905acf2face8ed2989a19edbcd9c.tar.bz2
elections-f07952719a64905acf2face8ed2989a19edbcd9c.zip
README: improve details about infra steps
Signed-off-by: Robin H. Johnson <robbat2@gentoo.org>
-rw-r--r--README.md25
1 files 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:
```