CompSci 307 : Fall 2021

GIT Workflow for Teams

The following workflow is suggested for your team projects to minimize merge conflicts. It is based on using one branch per person in the team and using Gitlab's Merge Request to share each person's changes with the team.

Clone the Project Repository

For team projects, you will clone the team repository directly (there should be no reason to fork your own copy) so that everyone is working on the same code base.

In Terminal, each person in the team should clone the shared team repository:

    git clone git@coursework.cs.duke.edu:CompSci307_2021Fall/PROJECT_teamNN.git

In IntelliJ, use New -> Open and select the folder you just created created when you cloned the team repository to your local machine

One Branch per Person

The advantage of using one branch per person (instead of each package or feature) is that it essentially assures that you are the only one using your branch, meaning you will only need to push your changes regularly so they are available in Gitlab and can be integrated into the master branch and you will not need to pull any new changes.

Each person in the team should create a branch for themselves to work on exclusively throughout the project:
```
    git checkout -b YOUR_NAME_OR_NETID
```

Then you would work in this branch as usual during the project:

    git add YOUR_UPDATED_FILES
    git commit -m "A useful comment for your team mates about this change"
    git push -u origin BRANCH_NAME

Integrate Your Changes with the Team

Merge Requests are a powerful tool provided by many online GIT repositories (including GitHub and BitBucket). It creates a web page representing the changes you intend to make to the repository in an easy to understand format that allows others to comment on your changes before accepting them. The request's web page also updates automatically if new changes are committed and pushed.

Rather than working directly with the master branch on your local machine, use Gitlab's Merge Request tool to manage integration
When you are ready to integrate your changes with the team's stable version of the project, go to the team's project repository web page
Select "Merge Request" from the top of the project and select "New Merge Request" on the resulting page
Select your branch as the "Source Branch" and master as "Target Branch" (master is the default), then select "Compare branches and continue"
If there are no conflicts, then simply wait for others on your team to approve the Merge Request
If there are conflicts, your team will need to resolve them. You can either do that directly on the web page or by changing your code locally then committing and pushing it again.
Note, if you do resolve the conflicts using the online interface you will need to pull those changes down to your branch's local copy before doing the next steps.

Integrate the Team's Changes with Your Code

This step is most likely to contain merge conflicts since you have been coding on your branch without worrying about what the rest of the team has been doing (so the longer you wait to push your code the more likely it is that you will cause conflicts).

After a Merge Request has been accepted by the team, there will be new code on the master branch
To merge this new code with your personal branch, you have two options:
1. Create a Merge Request on Gitlab (as above) from the master branch to your personal branch.
  This has all the advantages as above, including being able to use the web interface to resolve conflicts, and will require you to pull the changes down to your local repository after finishing. Also, using the web interface means you will never need to leave your branch on your local machine.
2. Use the command line to merge it directly. This can be more stream lined, especially if there are no conflicts.
Take a moment to admire the new updates to your project, then get back to work on your part of the project :)