git-wth-adrian

This repository is used to practice git commands and github workflows for the Git Good with Adrian workshop.

Practice Instructions

Setup

1. Install git on your machine
2. Configure git with your name and email
   • git config --global user.name "<your_name>"
   • git config --global user.email "<your_email>"
   • Do not use your student email!
3. Create a github account (again do not use your student email)

Part 1: Setup

1. Fork this repository to your github account
2. On local machine, create a directory C:\users\<yourname>\dev\
3. Navigate to the directory C:\users\<yourname>\dev\
4. Clone this repository to your local machine in current directory
5. Pull latest changes from upstream remote repository
   • If there is no upstream remote repository, add it with the following command
     • git remote add origin https://github.com/AdrianCapacite/git-good-wth-adrian.git
   • Pull latest changes from upstream remote repository
     • git pull origin master

Part 2: Make your changes

1. Create a new branch with your name
2. Edit the git_masters.json file
   • Follow the format of my entry in students
     • Name
     • Your perferred language
3. Add the file to the staging area
4. Commit the file to the local repository
5. Merge changes into the main branch
6. Push changes to the remote repository

Part 3: Dealing with merge conflicts

Sometimes merge conflics happen and you have to resolve them.

1. Merge the branch joe into the main branch

   • Git will tell you that there is a merge conflict

2. Open the file with the merge conflict, You will see the following

   •   <<<<<<< HEAD
       Your changes
       =======
       Joe's changes
       >>>>>>> joe

   • The between <<<<<<< HEAD and ======= are the changes in the current (main) branch

   • The between ======= and >>>>>>> joe are the changes in the joe branch

3. Delete joe's changes and keep your changes by deleting between ======= and >>>>>>> joe

4. Then delete the lines <<<<<<< HEAD, ======= and >>>>>>> joe

5. Commit the changes

6. Push changes to the remote repository

Part 3: Create a pull request

1. Log into github
2. Navigate to the upstream remote repository
3. Create a pull request
4. Wait for approval

Git Syntax

Basic Commands

Command	Syntax	Description
git clone	git clone <repository_url>	Makes a copy of a remote repository onto your local machine.
git pull	git pull <remote> <branch>	Fetch & merges changes from the remote repository to your local repository.
git push	git push <remote> <branch>	Copies & merges changes from your local repository to the remote repository.
git add	git add <file_name>	Adds changes made in the current working directory to the Index (Staging).
git commit	git commit -m "<commit_message>"\
git commit -a	Commits changes to the local repository.\
-a attribute specifies to commit changes straight from working directory to repository. Ignnores untracked files.

Branching Commands

Command	Syntax	Description
git branch	git branch	Lists all branches in the local repository.
git branch	git branch <branch_name>	Creates a new branch in the local repository.
git checkout	git checkout <branch_name>	Shows the specified branch or commit in the working directory.
git branch -d	git branch -d <branch_name>	Deletes the specified branch in the local repository.
git merge	git merge <branch_name>	Merges the specified branch into the current branch.
git rebase	git rebase <branch_name>	Replays commits from the current branch on top of the specified branch.

More Commands

Command	Syntax	Description
git status	git status	Shows the status of the working directory and staging area.
git log	git log	Shows the commit history for the current branch.
git diff	git diff	Shows the difference between the working directory and the staging area.
git revert	git revert <commit_hash>	Undos a specific commit with a new commit.
git reset	git reset <commit_hash>\
[--soft] [--mixed] [--hard]	Moves head to the specified commit.\
--soft keeps changes after specified commit in index\
--mixed keeps changes after specified commit only in working directory\
--hard discards all changes after specified commit

Additional resources

• Git Crash course: brandon1024/GITCRASHCOURSE.MD
• Git Cheat Sheet: https://training.github.com/downloads/github-git-cheat-sheet/
• Visual Git Cheat Sheet: https://ndpsoftware.com/git-cheatsheet.html

Extra tools

• GitKraken/GitLens - Visual Git Client