Scoping & Call for Applications

Quick links

Relevant CorrelAid actors

  • project coordinator

  • project lead (if found early)

Goals

  1. decide whether we should do a project with the organization

  2. if yes, scope the project

Checklist

Setting up the project

Add project to Kanban Board

We have a Kanban board in Trello to track the progress of all projects. Make sure to enter the project into the Kanban board to make the progress visible to everyone.

Data on metadata of projects - mostly for finished projects - is maintained separately in Directus.

Communication and Note Taking

In the scoping phase, you should aim to communicate regularly and repeatedly with the NPO to make sure that we a) really want to do a project with them and b) can define a project which will work for both the NPO and the CorrelAid team. Usually, 2-4 iterations over 1-4 weeks are necessary to define a project so that we can send it out via our newsletter.

In principle, you are free in how you communicate with the NPO: email, phone, video call or in-person are all valid choices. However, aim for at least one personal conversation (i.e. not email). It's a good idea to start sharing notes from the scoping process early with the NPO so that you can have a shared record of what your plans and ideas are.

Write down initial discussions and ideas and then move towards formulating a call for applications. To do so, it makes sense to create two Google docs based on the templates in this Google Drive folder.

  1. Create a subfolder for the project in the project-coordination drive

  2. Create one Google doc for taking notes during the initial call(s) --> template_scoping.

  3. Create another Google doc for the call for applications --> template_call_for_applications (there are German and English versions and a version for the projectcycle which would include multiple calls)

To create the docs from the templates:

  1. open the template folder and open the template you want. Select all content and copy to a new Google doc. OR:

  2. in the folder where you want to create the google doc (see step 1 above), right-click --> Google Docs --> From Template and then select the template from the gallery.

Scoping

There are several things you need to discuss with the NPO over the course of the scoping phase:

  1. content and scope of the project

  2. expectation management & organization commitments

  3. data security / privacy & data access

  4. timeline

  5. team size & composition

Content and scope of the project

This is arguably the most interesting part. Here, you and the NPO should elaborate together what should be part of the project and how CorrelAid volunteers can help the NPO while at the same time having a good learning experience.

What's a good CorrelAid project? When should we do a project? When not?

The ethics questionnaire is a great place to get an overview over criteria and potential ethical no-gos that could prevent a project.

pageThe Ethics Questionnaire and its Companion Document

This older guide can also be useful (will potentially be retracted in the future)

pageWhen do we do a project? When not?

Finding all this out might require a call with the potential partner, so don't make promises too early before you have established that this will be a good idea.

It is important to get as good a picture of the situation as possible. While this process is not standardized, here are some resources:

While coming to an agreement on the content and scope of the project is important, you should leave enough room so that goals can be adjusted later on in the project if necessary. Avoid going into too much technical detail in the project description. Focus on what the organization needs and fix the rough technologies (Python or R? Data Visualization or Machine Learning Model?), and leave the more detailed how to the project team.

Expectation management & Organization commitments

Another important part of the ideation phase is expectation management. You should make clear that:

  • ... CorrelAid is a volunteer-based organization. That means that the project team members are volunteers who will usually spend 3-5 hours per week on the project. It also means that rarely volunteers might drop out of the project because they're suddenly faced with other, unforeseen challenges in their life. CorrelAid is not a service provider or a business that can guarantee deliverables nor timelines.

If the organization requires:

  • a certain quality of the output

  • or a fixed, tight timeline

then skilled volunteering is not the correct format for this project/NPO. They should hire a freelancer or pay someone to do this instead.

  • ... CorrelAid projects do not only serve the NPO but also our volunteers by providing learning opportunites (see info box above). This also means that our project teams are diverse such that we do reserve at least one spot for a less experienced data scientist.

Fortunately, almost all NPOs will totally understand those points because they also rely on volunteering in their work. :)

In addition to those "soft" expectation management issues, you should also get the OK from the organization that they are willing and able to:

  • support the project team over the course of the project, i.e. they will be available for regular calls / email communication / meetings to answer questions and give feedback

  • will be able to participate in the kickoff

Data privacy & data access

We have a data security and protection team which is happy to help you navigate this sometimes complex topic. You can find them in the #data-protection-security Slack channel.

Data protection and privacy is very important to CorrelAid. Hence, you should find out early what kind of data is to be collected and/or analysed in the project so that the project lead and project team can take on appropriate measures to correctly store and process the data.

To make yourself familiar with the different types of data - especially the concept of "personal data" -, please check out the "types of data" section of the data security & privacy page:

pageData privacy & security

After you've familiarized yourself with the definitions, you should be able to decide on the right project setup together with the NPO by asking the following questions.

Will any kind of personal data be involved in the project?

If 👍:

Most of the times, CorrelAid teams will get a pseudonymized version of the data (i.e. individuals are still identifiable with the use of additional information). But even if the partner organization claims the data is truly anonymized, CorrelAid teams should not rely on that claim. Hence, in any case CorrelAid teams dealing with any kind of personal data should always adhere to the following setup:

Project setup

  • DO: encrypt the data on local machines (see howto)

  • DO NOT: upload data to GitHub / GitLab

  • DO: team members need to sign the declaration on data protection and security (de: Datenschutzverpflichtungserklärung) (templates are here)

  • DO (if very sensitive data): team members create separate user account on their machine just for the project

If 👎:

If the project does not involve personal data, it depends on the requirements and wishes of the NPO which data protection & security measures the project team needs to adopt. Here are the questions to ask the NPO.

Does the data have to be encrypted locally?

Make sure the organization understands the attack vector, i.e. if a laptop of a team member was stolen, the data could be extracted from the hard drive.

If data can be stored unencrypted, CorrelAid team members do not need to ensure encryption which can be easier, especially for team trainees.

Can the data be uploaded to a private GitHub repository?

Make sure that the organization understands that GitHub has their servers in the US. CorrelAid does not self-host a version control service.

With a private repository access to the repository would be limited to team members and the project coordinator. In consequence the data would only be accessible to team members and the project coordinator.

If data can be stored on GitHub, they can be put under version control, i.e. changes to raw data can be tracked and reverted easily if necessary. In addition, it makes collaboration in the team easier because the setup is shared through GitHub.

Can the code and data be published to a public GitHub repository?

If the organization decides to open source the code and data to the public, it is accessible to everyone.

Other organizations and data scientists can make use of our work and we would contribute to open source.

If the NPO decides that they are ok with open sourcing code + data, you should help them choose a license for data and code. https://choosealicense.com/ is a good resource for deciding this.

QuestionAnswerConsequence

Can the data be stored unencryped on the local machines?

Team members do not need to use VeraCrypt or encrypt their home folder.

Can the data be stored unencrypted on the local machines?

Team members need to use VeraCrypt or encrypt their home folder.

Can the data be uploaded to a private GitHub repository?

Team members can upload raw and all kinds of processed data to GitHub. The initial data transfer to the project team can be done using GitHub.

Can the data be uploaded to a private GitHub repository?

Team members cannot upload raw and processed data to GitHub. Instead, they should document relevant folder structures in the README of the repository and put the data folder in .gitignore. The initial data transfer to the project team needs to be done via the CorrelCloud.

Can the code and data be published to a public GitHub repository?

The repository can be public. Appropriate licences for code and data need to be chosen.

Can the code and data be published to a public GitHub repository?

The repository cannot be public.

Get written confirmation from NPO

Always confirm what you discussed in in-person or in calls via a clearly formulated email with the NPO, e.g. by copying the table above with the answers of the NPO and asking for their written confirmation of the agreed privacy rules. You can store the email in the Google Drive folder where you keep the organisational details of the project.

Timeline

Finally, you should also agree on a rough timeline. A usual project can look like:

PhaseApproximate Duration

Send out call for applications

Collecting applications

1.5-2 weeks

Team selection

1 week

Onboarding + coordination of kickoff

1-5 weeks

Kickoff workshop

online event (unless otherwise organized)

Project work

1-6 months

Handover workshop

either online (1-3 hours) or a in-person meeting (1-3 hours)

Final closing event

1 hour (CorrelAid) public event where the team and the NPO present their result to interested CorrelAiders (or even the public)

Follow-up

immediately after handover workshop and after several months

Please always add in a bit of buffer. Holidays etc. are a thing, so you shouldn't plan with all volunteers working 3-5 hours on the project all weeks.

Deadlines can be helpful!

If the organization has a certain deadline (e.g. the launch of a new website, their annual members meeting), use it to mark the end of the project. This way, the project team has a clear goal to work towards!

When to start projects?

projects that are started in autumn/spring are easier to really kick-off. Projects that start during the summer might quickly lose momentum due to members going on vacation and not seeing each other as often.

Team

A project needs a team. Before you send out the call for applications, you should define roughly how you would like the team to look like.

Size

Usually, CorrelAid teams consist of 4-6 people, but there can also be smaller teams (e.g. a two-person team) or larger teams if the project is very comprehensive and there are several sub-projects that can be worked on simultaneously.

Team size - always overstaff!

Previous experience has shown that there is usually a "loss" of 1-2 people over the course of a project. Hence, if in doubt whether you want x or x+1 people on the team, rather go with x+1. Rather overstaff than understaff!

Roles

With regards to skills, it can be useful to think of different "roles" that you want to fill. In a typical CorrelAid project, there are three types of team roles:

  • project lead / team lead: The project lead is a team member that has some additional responsibilities such as coordination of the team, being the primary contact person of the organization, and reporting back to the project coordinator (aka you). Usually, the project lead is also a more experienced data scientist who can help others with technical problems but this doesn't have to be the case. The project lead can also be someone who is very knowledgable and has high domain expertise.

  • team member: "regular" team member: upper beginner level, mid-level and experienced data scientists / data analysts.

  • team trainee: at least one position in every CorrelAid project is reserved for less experienced data scientists who are just at the start of their data science journey.

A usual CorrelAid project team looks like this:

  • 1 project lead

  • 2-4 team members

  • 1 team trainee

Depending on the project, you can also define two project leads or team trainees, or have more "regular" team members.

Find a team lead early!

When and how to find a team lead

Ideally, you have the position of the team lead filled before sending out the call for applications. This way, they can participate in the team selection process and can already be involved in some communication with the NPO. In addition, if you know the team lead personally, they will probably be more committed to the project's success.

If you don't know anyone who could be a candidate, ask around in the CorrelAid crew whether someone knows someone who could be interested in the project. In CorrelAidX contexts, ask people who have attended several meetups / who you know personally.

Call for Applications

CorrelAidX projects

In Mailerlite, we have so-called groups for all chapters, i.e. we can contact all CorrelAid members who are interested in activities of your CorrelAidX chapter. Usually, CorrelAidX projects should be sent out to this local newsletter list to give everyone in your area the chance to apply for the project. However, you can also draw from the global network if you want.

If you are just starting out as a chapter and just acquired your first project, it is also possible to form a team out of the initial members of the chapter without sending the project over your local section of the newsletter. In this way, you can experience a CorrelAid project together and pass on your knowledge in later projects.

Relevant CorrelAid actors

  • project coordinator

  • project lead (if already found)

Checklist

Draft the call for applications on CodiMD

Once you have decided together with the NPO that a project makes sense and you have a clear idea of the scope and content of the project, you can start drafting the call for applications (de: Projektausschreibung). The call for applications is the central way how we announce our projects and how we collect applications from our network.

You can draft the call for applications on Google Docs or CodiMD. In order to make this as easy as possible for you, we provide templates for this that closely mirror the structure of the Mailchimp template that you'll use later to send it out to the network.

Copy the content of the Google Template into a new Google doc (or create a new doc from the template) or CodiMD and rename it to reflect your project's name. Then you can start filling in the necessary information.

German or English?

This depends on the project. To be as inclusive as possible, the English one should be the default. However, if your project will be in German only and it is really not possible to participate without good German skills (i.e. because of the nature of the data), choose the German one.

Add project to KoboToolbox form

For project applications, we have a Kobotoolbox form that we use for all projects. At the beginning of the survey, applicants are asked to select which project they want to apply to. Hence, you need to add your project to this sign-up form.

  1. Open the form builder for the form "Applications for CorrelAid Projects".

  2. Click "add another response" under the question "Für welche Projekte möchtest Du dich bewerben?"

  • add the response option in the format {project_id}: title of the project, e.g. 2022-04-LAU: A project title. The : is important!

  • under XML value, add the project id, e.g 2022-04-LAU. This is important for data cleaning to work when generating the HTML reports.

  1. The question "Welche Rolle möchtest Du im jeweiligen Projekt einnehmen?" is a matrix question so the first block of its settings are the general configuration. Skip this and duplicate the block of one of the previous projects. You need to edit the title of the block but then also go to the settings (cog wheel) to edit the "data column name" there as well.

  1. Delete old entries from the two questions if they are not needed anymore because the application deadline has expired.

  1. Save the current state and exit the form builder with the "X".

  2. Update the translations by going to the Form tab and clicking on the Globe emoji next to Languages. Click again on the globe emoji next to English and find the two entries that you added in the form. You can just copy-paste whatever you put into the form builder because we do not translate the call for applications either. Important: the project ID stays the same, regardless of language.

  1. Click "Redeploy" in the "Form" tab to publish your changes

  2. Now your project is live and you an send out the call for applications to our newsletter linking to the form with this link: https://ee.correlaid.org/single/07382b4791fb16cf9bc1193c03848835 (this is the "online-only once per respondent" link)

Send with Mailerlite

Once you're finished drafting your call for applications and have checked back with the organization to get a go-ahead, you can send it out to our network using our Mailerlite newsletter list.

How can I only send to a local chapter?

Local chapters are stored in Mailerlite as groups. When building your Mailerlite campaign, you can select specific group(s) at the end of the process.

  1. log in to mailerlite using the projects@correlaid.org account

  2. create a mailerlite campaign

  3. content of the campaign:

  • if only one project: you can insert the whole call for applications into the mail

  • if multiple projects: insert the summary and overview blocks for each project and then link to the Google doc (don't forget to set "Viewer" permissions for "everyone")

  1. Choose the Volunteer Newsletter group as recipients.

FAQ

As always, if you have any questions, please ask in the #projects channel on Slack.

Last updated

The CorrelAid Docs are licensed under CC-BY 4.0.