Add template for CIVS opt-in

CIVS opt-in needs to be announced before voting kickoff so that
electorates participate in voting.
Creating template named: "voting_optin_civs".

Change-Id: I778ee2fcbcdd85599db3ec53c68fc1e6563d92df

README.rst

@@ -112,10 +112,14 @@ When PTL Candidacy submission ends:
 PTL Election Round
 ------------------
 
-When PTL Election begins:
+Before PTL Election begins:
 
-* Send email to eligible electorates to opt in to CIVS voting system using
-  their Gerrit email address in https://civs1.civs.us/cgi-bin/opt_in.pl
+* Send email to the mailing list or eligible electorates to opt in to
+  CIVS voting system using their Gerrit email address in https://civs1.civs.us/cgi-bin/opt_in.pl
+
+  * ``tox -e venv -- template-emails voting_optin_civs``
+
+When PTL Election begins:
 
 * `Create CIVS page
   <https://wiki.openstack.org/wiki/Election_Officiating_Guidelines#Running_the_election_itself>`_
@@ -242,14 +246,15 @@ with:
 
 * ``tox -e venv -- template-emails campaigning_kickoff``
 
-
 TC Election Round
 -----------------
 
 Before TC Election begins:
 
-* Send email to eligible electorates to opt in to CIVS voting system using
-  their Gerrit email address in https://civs1.civs.us/cgi-bin/opt_in.pl
+* Send email to the mailing list to opt in to CIVS voting system using their
+  Gerrit email address in https://civs1.civs.us/cgi-bin/opt_in.pl
+
+  * ``tox -e venv -- template-emails voting_optin_civs``
 
 * Create CIVS page
 

openstack_election/cmds/template_emails.py

@@ -20,7 +20,7 @@ start_release, _, end_release = conf['timeframe']['name'].partition('-')
 
 template_names = ['election_season', 'nominations_kickoff',
                   'nominations_last_days', 'end_nominations',
-                  'voting_kickoff', 'voting_last_days']
+                  'voting_optin_civs', 'voting_kickoff', 'voting_last_days']
 fmt_args = dict(
     email_deadline=conf['timeframe']['email_deadline'],
     end_release=end_release,

openstack_election/templates/combined_voting_kickoff.j2

@@ -21,16 +21,19 @@ start_release }} to {{ end_release }}) or if you are in that team's
 list of extra-atcs[2].
 
 If you are eligible to vote in an election, you should find your
-email with a link to the Condorcet page to cast your vote in the
-inbox of your Gerrit preferred email[3].
+email with a link to the Condorcet Internet Voting Service (CIVS) page
+to cast your vote in the inbox of your Gerrit preferred email[3].
 
 What to do if you don't see the email and have a commit in at
 least one of the projects having an election:
-* due to a new CIVS policy, to vote in a private CIVS pool,
+* due to a new CIVS policy, to get the email from poll supervisors,
     you must opt in to email communication
-    opt in with your gerrit email address at:
+    opt in with your Gerrit email address at:
     https://civs1.civs.us/cgi-bin/opt_in.pl
-* check the trash or spam folders of your gerrit Preferred
+* eligible voters who opt in to email communication late
+  can see a pending poll invitation and vote
+  until {{ election_end }}.
+* check the trash or spam folders of your Gerrit Preferred
     Email address, in case it went into trash or spam
 * wait a bit and check again, in case your email server is a bit slow
 * find the sha of at least one commit from the project's deliverable

openstack_election/templates/combined_voting_optin_civs.j2

@@ -0,0 +1,15 @@
+To: openstack-discuss@lists.openstack.org
+Subject: [all][elections][ptl][tc] Opt in to CIVS voting system
+
+The election uses the Condorcet Internet Voting Service (CIVS).
+Due to CIVS policy, to vote in private CIVS polls, you must opt in to email
+communication.
+
+To opt in, please enter your Gerrit email address in the following page before
+the start of the election {{ election_start }}, and confirm with the code that
+will sent to you via email.
+
+https://civs1.civs.us/cgi-bin/opt_in.pl
+
+If you have any question, please contact the election officials.
+https://governance.openstack.org/election/#election-officials

openstack_election/templates/ptl_voting_kickoff.j2

@@ -10,16 +10,19 @@ If you are a Foundation individual member and had a commit in one of
 the team's deliverable repositories[0] over the {{ time_frame }}
 timeframe ({{ start_release }} to {{ end_release }}) then you are
 eligible to vote. You should find your email with a link to the
-Condorcet page to cast your vote in the inbox of your gerrit
-preferred email[1].
+Condorcet Internet Voting Service (CIVS) page to cast your vote in
+the inbox of your Gerrit preferred email[1].
 
 What to do if you don't see the email and have a commit in at
 least one of the projects having an election:
-* due to a new CIVS policy, to vote in a private CIVS pool,
+* due to a new CIVS policy, to get the email from poll supervisors,
     you must opt in to email communication
-    opt in with your gerrit email address at:
+    opt in with your Gerrit email address at:
     https://civs1.civs.us/cgi-bin/opt_in.pl
-* check the trash or spam folders of your gerrit Preferred
+* eligible voters who opt in to email communication late
+  can see a pending poll invitation and vote
+  until {{ election_end }}.
+* check the trash or spam folders of your Gerrit Preferred
     Email address, in case it went into trash or spam
 * wait a bit and check again, in case your email server is a bit slow
 * find the sha of at least one commit from the project's deliverable

openstack_election/templates/ptl_voting_optin_civs.j2

@@ -0,0 +1,15 @@
+To: openstack-discuss@lists.openstack.org
+Subject: [all][elections][ptl] Opt in to CIVS voting system
+
+The election uses the Condorcet Internet Voting Service (CIVS).
+Due to CIVS policy, to vote in private CIVS polls, you must opt in to email
+communication.
+
+To opt in, please enter your Gerrit email address in the following page before
+the start of the election {{ election_start }}, and confirm with the code that
+will sent to you via email.
+
+https://civs1.civs.us/cgi-bin/opt_in.pl
+
+If you have any question, please contact the election officials.
+https://governance.openstack.org/election/#election-officials

openstack_election/templates/tc_voting_kickoff.j2

@@ -13,13 +13,20 @@ teams' deliverable repositories[2] over the {{ time_frame }}
 timeframe ({{ start_release }} to {{ end_release }}) or if you are
 one of the extra-atcs.[3]
 
+If you are eligible to vote in an election, you should find your
+email with a link to the Condorcet Internet Voting Service (CIVS) page
+to cast your vote in the inbox of your Gerrit preferred email[4].
+
 What to do if you don't see the email and have a commit in at least
 one of the official deliverables[2]:
-* due to a new CIVS policy, to vote in a private CIVS pool,
+* due to a new CIVS policy, to get the email from poll supervisors,
     you must opt in to email communication
-    opt in with your gerrit email address at:
+    opt in with your Gerrit email address at:
     https://civs1.civs.us/cgi-bin/opt_in.pl
-* check the trash or spam folder of your gerrit Preferred Email
+* eligible voters who opt in to email communication late
+  can see a pending poll invitation and vote
+  until {{ election_end }}.
+* check the trash or spam folder of your Gerrit Preferred Email
     address[4], in case it went into trash or spam
 * wait a bit and check again, in case your email server is a bit slow
 * find the sha of at least one commit from an official deliverable

openstack_election/templates/tc_voting_optin_civs.j2

@@ -0,0 +1,15 @@
+To: openstack-discuss@lists.openstack.org
+Subject: [all][elections][tc] Opt in to CIVS voting system
+
+The election uses the Condorcet Internet Voting Service (CIVS).
+Due to CIVS policy, to vote in private CIVS polls, you must opt in to email
+communication.
+
+To opt in, please enter your Gerrit email address in the following page before
+the start of the election {{ election_start }}, and confirm with the code that
+will sent to you via email.
+
+https://civs1.civs.us/cgi-bin/opt_in.pl
+
+If you have any question, please contact the election officials.
+https://governance.openstack.org/election/#election-officials