❤️Become a Contributor
Contribute to Code for Life
Last updated
Contribute to Code for Life
Last updated
As Code for Life is an open-source project, we welcome external contributors and all forms of contribution such as:
code changes
design
student resources
teacher resources
strategic insights from qualified teachers
process review
cloud infrastructure setup
running
If you would like to contribute in one of the ways mentioned above or in a way not mentioned above, please reach out at codeforlife@ocado.com - all help is welcome! 😉
Some of the reasons we would like to highlight:
Your contributions will be directly used by students and teachers worldwide, helping them to flourish in an increasingly digital world.
You'll learn a variety of technologies and gain experience developing a production-ready system.
You'll build your portfolio and industry-experience, which is highly valued by employers.
You'll have the satisfaction of making the world a better place, one contribution at a time. 😊
Want more reasons? See why you should contribute to open-source.
Get ready to dig in! 💪 We're hoping that contributing to this project will be as rewarding to you as it is to us. 🚀
We endorse and extend Python's Community Code of Conduct; please make sure you are friendly and welcoming.
Every contributor will need a GitHub account, regardless of whether they wish to contribute code or other types of work to the project. This is because we use GitHub to manage our project's tasks. If you don't already have a personal GitHub account, create one.
We recommend that you start your journey with us by reaching out to us at codeforlife@ocado.com and notify us of your intent to contribute. While it's not required to do this, we recommend starting a conversation with us early on so that we may learn more about your individual skill set and suggest tasks that you're suited to.
Notifying us of your intent to contribute is not a commitment on your part. You are never obligated to start or complete any work for CFL.
Before you begin contributing, you must first sign our contributor agreement. This gives CFL permission to use your contributions in our app! 🚀 After reading the agreement, you must sign it by following the below steps. If you have any trouble, please reach out to support@codeforlife.education.
See Git's first-time setup docs.
Set user.name to be anything you like.
Set user.email to be an email address that you own. Note that:
This email address will be forever publicly visible! If you wish to keep your personal email address private, then we recommend you create a new email address for the sole purpose of making contributions. If you have a GitHub account, you can add the new email address to it.
You cannot use a private/noreply email address. If you have a GitHub account, this is enabled by default and can be turned off at Settings > Emails > Keep my email addresses private.
You only need to fork the main branch.
See how to do this on GitHub.
On the main branch of your forked codeforlife-workspace repo, write your email address on a new line at the bottom of CONTRIBUTING.md.
You must not make any other edits!
Replace user.email with your email address.
Create a pull request from the main branch of your forked codeforlife-workspace repo to the main branch of Ocado Technology's codeforlife-workspace repo.
See how to do this on GitHub.
To affirm that you own the email address you provided, an email will be sent to the email address after your pull request has been reviewed and approved by a member of our team. The email will contain a link to the pull request that added the email address as a contributor. You must forward the email to codeforlife@ocado.com from the same email address and state:
All of our project's tasks are tracked using GitHub Issues - we use the words "issue" and "task" interchangeably. Each code repository has an Issues tab where you can browse the various tasks we have for the repo. You can find our list of repos by looking at our reading list.
Although you're welcome to pick up any task, not all issues are suitable for contributors. This is because some tasks require specialised knowledge or familiarity with how our system works. To help contributors find tasks we believe to be suitable for them, we label some of our tasks with a volunteers tag.
You can search for these with the filters:
Furthermore, we label some tasks with good first issue that we believe to be easy enough for first time contributors:
If you are contributing code changes, we recommend you spend a little time skimming through the docs of our different code repos (see our reading list). This will give you some insight into how our system is structured and, given that each task is associated to a repo, you'll have a high-level understanding of the area of the system that you'll be working on.
Once you have an overview of our system, set up your development environment.
All dev contributors will need to have these skills to contribute code changes:
A basic understanding of what Git does. You'll need to know what the following commands do:
git clone
git pull
git commit
git push
A basic understanding of what Docker does.
A basic understanding of what VSCode does.
It's recommended contributors wishing to contribute to our back end familiarise themselves with:
You don't have to be familiar with all these technologies - as long as you are keen to learn.
It's recommended contributors wishing to contribute to our front end familiarise themselves with:
You don't have to be familiar with all these technologies - as long as you are keen to learn.
The basics of HTML.
The basics of CSS.
The basics of JavaScript and TypeScript.
The basics of React.
The basics of Cypress.
Below is everything you need to know about how to handle tasks as a contributor.
Before you start working on a task, we recommend you reach out to us at codeforlife@ocado.com so that we may assign the tasks you're working on to your GitHub account.
If you're a dev contributor, you'll first need to fork any repo you wish to develop for. You should have forked all of CFL's repos when you set up your dev environment.
If you've been assigned a task and we've seen no activity from you in the past 2 weeks, you'll be unassigned so that others may have a chance to pick up the task. You can always be re-assigned if you so wish.
If you have questions or require guidance, we'll do our best to respond promptly and provide you with support.
Our preferred communication channel is GitHub - we ask you make comments directly on a task so that we may keep all conversations regarding a specific task in a central location. Otherwise, you may reach out to us at codeforlife@ocado.com or via the email address of any CFL team member you may have previously been in contact with.
When you've completed your task, you must request a review from us to determine whether we can accept your contribution. The simplest way to do so is to comment on the task:
If you're a dev contributor, review requests will come in the form of pull requests from your forked repo.
If we discover issues in our review, we'll request changes. It's normal to have multiple rounds of review requests (by you) followed by change requests (by us) until the task is completed to our standards. Change requests will usually be commented directly on their respective GitHub task or pull request.
Once a task has been closed by us we'll go through some internal processes which will ultimately result in your contribution getting deployed in the next version of system.
It may take some time before your accepted contributions are live on our system as we batch changes and release them as new versions on our system.
You can see when your contributions have been released by keeping an eye on our release notes. However, we're aiming to improve our notifications so you're kept in the loop every step of the way.
