Skip to content

Commit

Permalink
Update materials for 2018
Browse files Browse the repository at this point in the history
  • Loading branch information
christopher-llop committed Jan 2, 2018
1 parent e3baeae commit 1dc3bc0
Show file tree
Hide file tree
Showing 7 changed files with 43 additions and 54 deletions.
26 changes: 12 additions & 14 deletions Completing Your First Exercise With Git Reading Card.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Before proceeding, use the following instructions to set up your local assignmen

**Download [1.15 The Course Workflow.pptx](https://github.com/MIDS-INFO-W18/Course-Syllabus/blob/master/week_01/1.15%20The%20Course%20Workflow.pptx) for a diagram of this process**

1. **assignment-upstream-fall17** - You should be able to find this repository in our class organization on GitHub: **https://github.com/MIDS-INFO-W18/assignments_upstream_fall17** (or https://github.com/MIDS-INFO-W18/assignment-upstream-w18 for the 10 week course). This is where we will post all class assignments. You have read access to this repository, and each week you will use a pull command to download the latest assignments to your own machine then push your submissions to your student repository **(recall the "V" shape)**.
1. **assignments-upstream-spring18** - You should be able to find this repository in our class organization on GitHub: **https://github.com/MIDS-INFO-W18/assignments-upstream-spring18**. This is where we will post all class assignments. You have read access to this repository, and each week you will use a pull command to download the latest assignments to your own machine then push your submissions to your student repository **(recall the "V" shape)**.
2. **Your student repository** - In this excercise you will make your own student remote repository. You should have write access to your student repisitory, but it will be only readable by you and your instructors. When you complete your homework each week, you will use a push command to upload your work to this repository.

## Initial Setup
Expand Down Expand Up @@ -53,7 +53,7 @@ First create an empty repository in Github for your homework, you can do this th
## Clone the assignments directory on your system


You need to tell git that you will be pulling content (homeworks) onto your machine from assignment-upstream-fall17 and pushing modified content (completed homeworks) to YourNameREPO on github
You need to tell git that you will be pulling content (homeworks) onto your machine from assignments-upstream-spring18 and pushing modified content (completed homeworks) to YourNameREPO on github

Open a command prompt and use it to navigate to your desktop or course working directory. Then execute the following commands:

Expand All @@ -62,16 +62,14 @@ Open a command prompt and use it to navigate to your desktop or course working d
``` sh
# clone the assignment repository onto your computer

git clone https://github.com/MIDS-INFO-W18/assignments_upstream_fall17.git
# (or https://github.com/MIDS-INFO-W18/assignment-upstream-w18.git for the 10 week course)
git clone https://github.com/MIDS-INFO-W18/assignments-upstream-spring18.git

# Note: This may be an empty repository at the beginning of the course.

cd assignments_upstream_fall17
cd assignments-upstream-spring18
# (or cd assignment-upstream-w18 for the 10 week course)

git remote add upstream https://github.com/MIDS-INFO-W18/assignments_upstream_fall17.git
# or git remote add upstream https://github.com/MIDS-INFO-W18/assignment-upstream-w18.git
git remote add upstream https://github.com/MIDS-INFO-W18/assignments-upstream-spring18.git
```

You can find the URL for YourNameREPO by navigating to the appropriate repository in your web browser, then clicking on the "Clone or download" button in the upper right corner.
Expand Down Expand Up @@ -106,17 +104,17 @@ git remote -v

## Workflow for Each Week

Each week, you will begin by navigating to your local version of **assignments_upstream_fall17**, and downloading the latest changes from the remote assignments-upstream-fall17 repository. You do this with a git pull:
Each week, you will begin by navigating to your local version of **assignments-upstream-spring18**, and downloading the latest changes from the remote assignments-upstream-spring18 repository. You do this with a git pull:

``` sh
git pull upstream master
```

Next, you will have a **assignments_upstream_fall17/SUBMISSIONS** folder that you will make in the next exercise.
Next, you will have a **assignments-upstream-spring18/SUBMISSIONS** folder that you will make in the next exercise.

* Make a copy of your assigmment and move it to the SUBMISSIONS folder.

* Complete all the exercises in the **assignments_upstream_fall17/SUBMISSIONS** folder on your local machine and commit your changes to git.
* Complete all the exercises in the **assignments-upstream-spring18/SUBMISSIONS** folder on your local machine and commit your changes to git.

* Finally, you'll push your changes up to your personal student repository on github. You can do this with the following command:

Expand All @@ -127,11 +125,11 @@ git push origin master

## Completing the Exercise

For this exercise you will post your first work to the assignments-upstream-fall17 repository. The Github repository **installation** contains the exercise.
For this exercise you will post your first work to the assignments-upstream-spring18 repository. The Github repository **installation** contains the exercise.

* Make a new folder called **"SUBMISSIONS"** in your local assignment-upstream-fall17 folder
* Make a new folder called **"SUBMISSIONS"** in your local assignments-upstream-spring18 folder

* Try using the **mkdir** command from within your local assignment-upstream-fall17
* Try using the **mkdir** command from within your local assignments-upstream-spring18

* Clone the installation directory to your local machine

Expand All @@ -141,7 +139,7 @@ git clone https://github.com/MIDS-INFO-W18/Installation.git

* Copy the file "First\_GitHub\_Exercise.txt"
* From your local **Installation** directory.
To your local **assignments_upstream_fall17/SUBMISSIONS** folder (or **assignment-upstream-w18/SUBMISSIONS** folder)
To your local **assignments-upstream-spring18/SUBMISSIONS** folder (or **assignment-upstream-w18/SUBMISSIONS** folder)
* To copy the file you can practice using the command line **cp** command or just drag and drop the file.

* Open the file, answer the questions, and save.
Expand Down
31 changes: 31 additions & 0 deletions Install 1 - Bash and Git.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@

# Bash, Git, and GitHub setup instructions

In this class you will use **bash** (also known as terminal or shell) to submit certain commands using text via the "command line". You will also use **Git** to manage code versions and **GitHub** to share and access code online. This card details installation instructions.

Before starting the process below, if you do not have a GitHub account you should sign up for one. Go to the [GitHub Homepage](https://github.com) and select "Sign Up". If you sign up with academic credentials, you can gain access to paid features by requesting a [free student account](https://education.github.com/) (not required for this course).

* Windows users should install "Git Bash" along with Git and GitHub via the installer below. If you do not use this method, you will run into technical problems.
* Linux and Mac OS users already have "bash" (called "terminal" on a Mac) installed by default. Mac users can access Terminal via their Spotlight search, and pin it to the dock for easy access.


## Windows users: Installing Git and Linking to GitHub

The steps on a Windows machine are slightly more complicated because you will also need to install Git Bash, a terminal program that allows you to interact with GitHub from the command line.

1. Download the latest version of [Git](https://git-scm.com/downloads).
2. Run the installer, and make sure to pick the option to install Git Bash in addition to the default options. All other items can be left to their default setting.
3. On your computer, open the Git Bash application.
4. Follow instructions 3 and 4 from the "Mac/Linux users" installation instructions below.


## Mac/Linux users: Installing Git and Linking to GitHub

The instructions below replicate those found online through [GitHub](https://help.github.com/articles/set-up-git/).

1. Download and install the latest version of [Git](https://git-scm.com/downloads).
2. On your computer, open the Terminal application.
3. Tell Git your name so your commits will be properly labeled. Type everything after here: git config --global user.name "YOUR NAME"
4. Tell Git the email address that will be associated with your Git commits. The email you specify should be the same one found in your GitHub email settings. To keep your email address hidden, see "[Keeping your email address private](https://help.github.com/articles/keeping-your-email-address-private/)". Use the following command: git config --global user.email "YOUR EMAIL ADDRESS"

You can now use Git and access GitHub via the Terminal. You will use this program whenever you need to enter command line commands in this course.
Binary file added Install 1 - Bash-and-Git.pdf
Binary file not shown.
40 changes: 0 additions & 40 deletions Install 1- Bash and Git.md

This file was deleted.

Binary file removed Install 1- Bash and Git.pdf
Binary file not shown.
File renamed without changes.
File renamed without changes.

0 comments on commit 1dc3bc0

Please sign in to comment.