Skip to content

Latest commit

 

History

History
122 lines (82 loc) · 4.92 KB

fetching-changes.md

File metadata and controls

122 lines (82 loc) · 4.92 KB
Raw

How to Fetch Devbootcamp's Curriculum Changes

Devbootcamp makes modifications and edits to the curriculum often. When this happens you'll need to "fetch" the changes from Github.com into your personal repository. This can be confusing to do, so thankfully, we've created this handy guide for you to do it via the command line or GitHub app.

It's important to note that fetching changes will NOT override your work. On the rare occasion we do modify a 'my_solution' file, you may have a merge conflict, All you'll have to do is select which parts you want. This is not likely to happen, so don't worry about it much.

Navigate to the appropriate directory in your terminal. Make sure you are in the master branch of the repo you want to update (phase-0-unit-1, phase-0-unit-2, or phase-0-unit-3. Check this by running git branch in your terminal. DO NOT try fetching changes into a different repo (than the one you want to update) or your [USERNAME].github.io repo. You will mess things up!

Using the Command Line

(Adapted from Github).

Note: Syncing your fork only updates your local copy of the repository; it does not update your repository on GitHub.

Setting up a new remote (link to a repository hosted on github.com)

You'll only need to do set up a remote once!

####1. Check where you are in your terminal! Type pwd to see which directory you are in. Make sure you are in the correct directory for fetching. You want to make sure all of your phase-0 repositories and your github.io sites are all separate. If you do not check where you are, you will likely make a mistake and cause a lot of problems.

####2. Check your current remote. This should link to your personal fork.

$ git remote -v
# List the current remotes
# origin  https://github.com/[your_username_here]/repo.git (fetch)  #This will either have https or ssh url
# origin  https://github.com/[your_username_here]/repo.git (push)

####3. Set up a new remote

$ git remote add upstream https://github.com/Devbootcamp/phase-0-unit-1.git 
# You are adding Devbootcamp's repository saying you want to be able to fetch (grab changes) from it.

####4. Verify your new remote

$ git remote -v

origin    https://github.com/[your_username_here]/repo.git (fetch)
# origin    https://github.com/[your_username_here]/repo.git (push)
# upstream  https://github.com/Devbootcamp/phase-0-unit-1.git (fetch)
# upstream  https://github.com/Devbootcamp/phase-0-unit-1.git (push) # You do not want to push to this repository!

Updating your local repository

You have a couple of steps to add changes from Devbootcamp's repository.

####1. Fetch the Changes Fetching from Devbootcamp's remote repository will bring in Devbootcamp's changes into a special branch in your local repository. Note: it's not merged yet

$ git fetch upstream
# Grab the upstream remote's branches
# remote: Counting objects: 75, done.
# remote: Compressing objects: 100% (53/53), done.
# remote: Total 62 (delta 27), reused 44 (delta 9)
# Unpacking objects: 100% (62/62), done.
# From https://github.com/Devbootcamp/phase-0-unit-1
#  * [new branch]      master     -> upstream/master

Now the upstream's master branch is stored on your local branch, upstream/master

$ git branch -va
# List all local and remote-tracking branches
# * master                  a422352 My local commit
#   remotes/origin/HEAD     -> origin/master
#   remotes/origin/master   a422352 My local commit
#   remotes/upstream/master 5fdff0f Devbootcamp's latest commit

###2. Merge the changes Now that you have Devbootcamp's changes stored in your local repository, you need to merge the changes with yours.

First make sure you are on your master branch.

$ git branch
* master

#OR

$ git checkout master
# switch to your master branch

Then merge the changes.This will bring your master branch into sync with Devbootcamp's master branch - and you won't lose your local changes.

$ git merge upstream/master
# Merges upstream's master into your local forked repository

If you did not have any un-synced commits, git will perform a "fast-forward".

Sometimes git will open up a vim or sublime window and ask for a commit message. If you're in sublime, you can simply save and quit, or change the top line with a commit message you choose - then save and quit.

If you have a weird window pop up that looks like this: vim window


you'll want to set up sublime text as your default text editor (step 3).

###3. Commit and push your new local repository with your remote fork on github.com

$ git commit -m "added Devbootcamp's changes"

$ git push origin master
# origin refers to the name of the remote repo
# master refers to the name of the branch you are pushing

###4. Check github.com! Look at your master branch on github.com. It should have your changes!