Annual Toolforge Survey/How to

= Steps =
# Create a phabricator task for the survey (such that there's one task per year).
# Draft and review the message body for the survey announcement.
# Copy, update, review the survey form. The survey lives on LimeSurvey.
# Publicly announce survey (typically on a Monday in November).
# One week later remind with "[Reminder]" prepended to subject.
# About a day before the survey ends remind with "[Final reminder]" prepended to the subject.
= Announcement template =
Subject: Participate in the Wikimedia Cloud Services Annual Survey (2021)
Hello!
You are receiving this email because you are a member of the Toolforge project or you are a project admin for a Wikimedia Cloud VPS project.
We, the Wikimedia Cloud Services team, are conducting this survey to learn more about how developers use our services and how they can be improved to address their needs. This survey will take between 10 minutes and an hour of your time, depending on how much feedback you would like to share with us in the form of free form comments.
This survey will be conducted via a third-party service, which may subject it to additional terms. For more information on privacy and data-handling, see the survey privacy statement [0].
If you agree to these terms and conditions, please go to https://wikimediafoundation.limesurvey.net/565681 to participate in the survey. 
The survey will end on Tuesday, Dec 20th, 2022.
If you do not wish to receive future Cloud Services annual survey emails, add your Wikimedia developer account name (i.e. the username you use to login to wikitech.wikimedia.org) to the opt-out list [1].
If you want to learn more about the survey and its result, please visit: <https://meta.wikimedia.org/wiki/Research:Cloud_Services_Annual_Survey/2021>
[0]: https://foundation.wikimedia.org/wiki/Legal:2022_Wikimedia_Cloud_Services_Survey_Privacy_Statement
[1]: https://wikitech.wikimedia.org/wiki/Annual_Toolforge_Survey/Opt_out
= Reminder template =
Subject: 1 week left - Participate in the Wikimedia Cloud Services Annual Survey (2021)
Reminder, there is only one week left to fill the survey. We would really appreciate your feedback.
Wikimedia Cloud Services team, is conducting this survey to learn more about
how developers use our services and how they can be improved to address their needs.
We would really appreciate your feedback.
If you have already filled out the survey, thank you!
* Privacy policy: https://foundation.wikimedia.org/wiki/Legal:2022_Wikimedia_Cloud_Services_Survey_Privacy_Statement
* Survey Form: https://wikimediafoundation.limesurvey.net/565681
* Opt out: https://wikitech.wikimedia.org/wiki/Annual_Toolforge_Survey/Opt_out
= Bulk emailing instructions =
Tools for generating the survey list can be found at https://gitlab.wikimedia.org/repos/cloud/wmcs/wmcs-survey-mail-list
The scripts should be run on a `cloudweb` host.
Make a list of usernames suitable for surveying all Toolforge
maintainers + Cloud VPS project admins.
$ python3 make-toolforge-user-list.py > users.txt
$ python3 make-cloudvps-user-list.py >> users.txt
$ sort users.txt | uniq > all-users-sorted.txt
Once the list of recipients is complete, send emails using https://www.mediawiki.org/wiki/Manual:SendBulkEmails.php. Be sure to specify --optout https://wikitech.wikimedia.org/wiki/Annual_Toolforge_Survey/Opt_out (eg. --optout "Annual_Toolforge_Survey/Opt_out")