In this second activity, you'll work like you are a member of the team. This activity will give you a good overview of how you can work with the repository while minimizing your team conflicts.
If you have not completed activity 1, you should do that prior to this activity.
- Use your
forked
version of the repo to complete the activity.
Whenever you start on a new ticket, before you begin any work, you should make sure to get the latest version of the code, then checkout a branch.
In this task, you will run commands to make sure that you have the latest code and that you can do your work in the safest way possible.
-
Get the latest version of the code
Even though you likely just cloned this repository, it's a good habit to make sure that you have the latest version of the code before checking out a new branch.
Make sure you have cloned the repo and that your GIT tool is on the master branch. If you are not currently on the master branch, you can move to the master branch with the command:
git checkout master
Once you are certain you are on the master branch, get the latest code using a fetch and a pull. You can run them individually, or all at once. To run them individually, use the following commands:
git fetch git pull
If you would like to run the commands at the same time, you can use the following command:
git fetch && git pull
Additionally, when branches have been deleted from the remote you can make sure to update your local references with the command:
git fetch --prune && git pull
Running this command will always make sure you get the latest version of the master branch and will let your local references know which branches have been deleted.
-
Create your new branch
With the latest version of the code, it's time to create your new branch. Hopefully you have a new ticket that you are working on. With a way to make a unique branch name, follow a pattern that makes sense to your team. For this example, assume you have a ticket number 54321 and that it is for 'learning git'. Create a new branch that includes the number, the simple summary, and your name. For example:
git checkout -b 54321-learning-git-brian
In the event that the branch already exists, use your initials or your git username to ensure uniqueness.
-
Add a file
In the folder
TeamMemberFiles
add a new file with your name, similar to this:touch firstname.lastname.txt
Then open the file for editing in your favorite text editor, and add the following information to the text file.
- Your first and last name
- How you like to be addressed (for example James might say "Call me Jim").
- What is your section number (294, 394, 495)
- What is your preferred tech stack (Java/Microsoft/MySql/Sql/Postgres/Vue/Angular/React/HTML/PHP)
- Anything else you want me to know (remember this is public to everyone in the course).
Save and close the file.
-
Commit your changes
To commit your changes, first you must stage your changes. To do this, you would begin by running a command to stage the file changes
git add .
Instead of the '.' you could explicitly name the file, but the '.' will include all of your changes.
Next, commit the changes with the command:
git commit -m "<YourName>'s submission for Activity 2"
Once the changes are committed, push the changes.
-
Push your changes
Since you've never pushed this new branch, you should run the command
git push -u origin <your-branch-name>
This will push your changes to the remote repository.
-
Create a pull request.
At GitHub, create a pull request for your changes and tag your instructor as a reviewer on the pull request.
There are two ways to create a PR. If you can see your branch has just made changes, you can easily click on the button to create a new PR. If you can't see your branch having changes, then click on the branches tab.
If you clicked on branches, find your branch and create a new PR from this screen
After clicking to create the pull request, fill out the comments and assign your instructor and yourself to the PR. Then hit the final "Create" button
You can see the PR is ready for review at any time. The person assigned to review should review it and perform the merge.
This will complete your GIT activity. In this activity, you learned how to work with a branch and create a pull request so that you can ensure your changes can be merged into the repository without creating a conflict.