diff --git a/MANIFEST b/MANIFEST index c00b86265b3c..9e6595a4c886 100644 --- a/MANIFEST +++ b/MANIFEST @@ -5422,6 +5422,7 @@ Porting/timecheck.c Test program for the 2038 fix Porting/timecheck2.c Test program for the 2038 fix Porting/todo.pod Perl things to do Porting/valgrindpp.pl Summarize valgrind reports +Porting/vote_admin_guide.pod Perlgov Vote Administrator guide pp.c Push/Pop code pp.h Push/Pop code defs pp_ctl.c Push/Pop code for control flow diff --git a/Porting/README.pod b/Porting/README.pod index 5b8038aac1f4..2b1c51cdd854 100644 --- a/Porting/README.pod +++ b/Porting/README.pod @@ -379,5 +379,9 @@ collects all these files, extracts most of the information and produces a significantly shorter summary of all detected memory access errors and memory leaks. +=head2 F + +Guide for Vote Administrators for running Steering Council elections. + =cut diff --git a/Porting/vote_admin_guide.pod b/Porting/vote_admin_guide.pod new file mode 100644 index 000000000000..2c4e256ea2e9 --- /dev/null +++ b/Porting/vote_admin_guide.pod @@ -0,0 +1,176 @@ +=encoding utf8 + +=head1 NAME + +vote_admin_guide - Perl Governance Vote Administrator Guide + +=head1 Running a Steering Council nomination process + +Announce the nomination period to the Perl Core mailing list. Be explicit +about the end time. Set a calendar reminder for yourself for when it's +time to close the nominations and begin the voting. + +If someone outside the Core Team is nominated, contact them to confirm that +they accept the nomination. If they do, ask the Steering Council to add +them as a moderated member of the Perl Core list for the duration of the +election and invite them to offer a statement on their candidacy to the +list. + +Remind inactive Core Team members that they have until the end of +nominations to reactivate themselves if they wish to vote. + +Before the end of the nomination period, remind everyone of the schedule +and share the current list of nominees to confirm you aren't missing +anyone. + +At the end of the nomination period, notify the Perl Core list of the list +of nominees and set their expectations for when you'll be opening the +voting period. + +=head1 Using CIVS + +We are using L +(CIVS), which is pretty easy to use, although it has a lot of options. + +First, bookmark that link, but realize that there are no user accounts. +Whenever you create or participate in a poll, you'll get a unique URL, and you +need to save it to come back to what you were doing before. + +=head2 Preliminary work + +You'll need to complete these steps. + +=head3 Get list of active Core Team member emails + +Ask Rik Signes for an up-to-date list of active Core Team member emails from +the TopicBox mailing list. + +B: Replace this step with a machine-readable list of email addresses in +C. + +=head3 Remind Core Team members to opt-in their email address + +CIVS has a required opt-in to send polls out to an email address. The +active Core Team members that would like to vote and haven't opted-in yet +must use the following link with the email address they use for the +perl-core mailing list: L + +=head2 Running an election on CIVS + +The following instructions describe steps to run an election. + +=head3 Creating a poll + +On the right sidebar of the CIVS landing page is a list of links, and the +first one is Create a poll. Some of the things it asks for are simple: +what's it called? Who is running it? It asks for an email address, and it +has to work: that's where you're going to get all the links! + +Note that "day and time you plan to stop" is just a text box. It gets sent +to the recipient in their invitation to vote. It does not schedule one +dang thing, so you better set yourself a reminder to close the poll on +time! Also, remember to think about time zones! (You are free to +selfishly pick your local time.) + +The description box is limited HTML: you can put in C<<

>> and +C<< >> and C<<