Below is a teamwork contract template adapted from Carnegie Mellon University. It is divided into several sections, and it is expected that each group will spend some time generating at least 5 points for each section that everyone agrees to.
If you are not able to agree on these points, it is a sign that your group may become dysfunctional, and you should seek advice from me (the course instructor) ASAP to resolve and mediate the discussion.
| Name | GitHub Handle |
|---|---|
| Navdeep Singh Saini | @navdeep94 |
| Bowen Yang | @boweny0319 |
| Can Jiang | @CenatexCJ |
All team members agree to fully participate in all aspects of the project. To accomplish this goal, below are five concrete actions that we all agree to take:
- We will work together to divide tasks evenly.
- We will all show up to meetings.
- We will do our best to communicate effectively.
- Make an effort to document code so others can edit it later.
- Make sure your code is reusable/efficient, and follows best practices.
All team members agree to communicate openly and transparently during the project. To accomplish this goal, below are five concrete actions that we all agree to take:
- Actively share ideas and discuss in the group chat.
- Make detailed and descriptive commit messages.
- Alert teammates when you make a pull request so we can all talk about it.
- Reach out if you need help and help others when they need it.
- Actively discuss the progress of the project.
All team members agree to meet regularly during the project. To accomplish this goal, below are five concrete ideas that we all agree to regarding scheduling and frequency of meetings:
- Meet every week during lab time (1:30 - 3:30 pm Kelowna time, on Wednesdays)
- Meet on Saturdays over zoom, discuss in chat to find times that work for everyone.
- Set up more impromptu meetings if required.
- In meetings share thoughts openly with eachother.
- In meetings, make sure everyone has their voice heard.
The code of conduct we have chosen is in the Code of Conduct document. All team members agree to following the code of conduct, and below are five concrete escalation steps that we all agree to follow in the event that the code of conduct is violated by any member of the group (Step 1 is the first thing you will do, and Step 5 is the last thing you will do).
- Have a text conversation with teammates in the group chat.
- Have a live face to face conversation with teammates.
- Come up with a new plan moving forward to address the issues.
- Reach out to Amanat if we need help.
- Reach out to Firas
N.B. Please do not hesitate to expand beyond 5 steps if needed.
Despite our best intentions, conflict may invariably arise within teammates. Discuss amongst your team some conflict mitigation strategies (feel free to search online if needed) and come up with 5 strategies all members of the team agree to follow in the event there is a conflict within the group. You may also include things you will NOT do in the event a conflict arises.
- Remember we are all in this together and trying our best.
- Take a break/walk.
- Don't take your frustrations out on fellow teammates.
- Be kind to eachother.
- Use a voting system to make team decisions.
All team members agree to the following conventions around course deadlines:
- Finish the project at least 2 days before the deadline.
- Use the 2 days before the deadline for review and to address any concerns.
- If you know you're struggling to reach a particular deadline, reach out to your teammates so that they can help you.
There are many git workflows possible when working on a team project with many moving parts. I suggest you discuss in your group some possible Git workflows. Here is a brief primer on some common options. I suggest reading them, understanding them, and then selecting one. You can explore and choose any you like, but if you cannot decide, I suggest using the "Feature Branch Workflow".
All team members agree to the [Name of chosen Git Workflow] workflow, and the following conventions (e.g., master branch protection, at least X reviews before a pull request, at least N days before the deadline etc...):
- Only add new features in your own branch.
- Test all of you code before issuing a pull request.
- Issue all pull requests at least 2 days before the deadline.
- At least one team member must review before accepting a pull request.
- Master branch must have no errors at all times (keep it protected, don't merge bad code!)
** This section should be completed AFTER Milestone 4 is done and submitted! Only one is needed PER group. **
In this section we will ask you to self-report the workload distribution to various categories of tasks. For each of the categories, we want you to report the approximate workload distribution, split by the milestone.
Here are the tables you are expected to complete (the first one is pre-filled in so you can see what we're expecting):
| Category | Navdeep Singh Saini | Can Jiang | Bowen Yang |
|---|---|---|---|
| Repository Setup | 40% | 30% | 30% |
| Sketch | 20% | 40% | 40% |
| Documentation | 40% | 30% | 30% |
| Project Management | 40% | 30% | 30% |
| Troubleshooting | - | - | - |
Brief notes/explanations (optional):
- No troubleshooting was needed for Milestone 1
- Can and Bowen did more on drawing sketch, whereas Navdeep did more on the documentation and project management. All work was done according to group agreement.
| Category | Navdeep Singh Saini | Can Jiang | Bowen Yang |
|---|---|---|---|
| Documentation/Reflection | 40% | 30% | 30% |
| Writing new code | 33% | 33% | 33% |
| Code Reviews/editing | 30% | 30% | 40% |
| Project Management | 40% | 30% | 30% |
| Testing & Troubleshooting | 30% | 30% | 40% |
Brief notes/explanations (optional):
| Category | Navdeep Singh Saini | Can Jiang | Bowen Yang |
|---|---|---|---|
| Documentation/Reflection | 40% | 30% | 30% |
| Writing new code | 33% | 33% | 33% |
| Code Reviews/editing | 30% | 30% | 40% |
| Project Management | 40% | 30% | 30% |
| Testing & Troubleshooting | 30% | 30% | 40% |
Brief notes/explanations (optional):
| Category | Navdeep Singh Saini | Can Jiang | Bowen Yang |
|---|---|---|---|
| Documentation/Reflection | 40% | 30% | 30% |
| Writing new code | 33% | 33% | 33% |
| Code Reviews/editing | 30% | 30% | 40% |
| Project Management | 40% | 30% | 30% |
| Testing & Troubleshooting | 30% | 30% | 40% |
Brief notes/explanations (optional):