Pull-Request-Challenge

Newbie Coder Warehouse challenges you to get better acquainted with git and Github.

This challenge should only take you between 2 and 10 minutes to complete, depending on your familiarity with git and Github.

####Table of Contents

• Required Materials for all participants
• Git and Github resources
• Which Route to Take
• Beginner Route
• Intermediate and Advanced Route

Required Materials for all Participants

1. A Github account. To sign up, visit: https://github.com/join

That's it! :)

Git and Github Resources

• git - the simple guide which give you a quick overview of the git workflow.
• Pull Request Video

####Which route to take? If you have little or no previous experience with git and Github, then take the beginner route.

If you have some experience with adding, committing, and pushing Github projects either locally or through an IDE, we recommend the Intermediate/Advanced route.

###Beginner Route

Knowledge/Experience

Some basic knowledge of git and github but not required.

Steps

1. Go to the Pull-Request-Challenge Github Repository

• If you reading this direction set from the README.md file, then you are in the repository.

2. Click on the template.md document. (Note: this is the doc you will edit.)
   
3. After the template.md page loads, click on the "edit this file" button (to the left of the trash can)
   • The hover text will say "Fork this project and edit the file"
     
   • Forking projects means that you have a version of this repository connected to your Github account. So basically you have the complete version of the challenge for you to change and send back to NCW for us to add your file (a copied version of template.md with your answers) to the project. Pretty cool huh?
4. After the page loads, you'll see this:
   Change the name of the file from the original 'template.md' to 'yourgithubusername.md'.
   This will save a new file to the forked project and will be the file that you will do a pull request for us to merge together on the main NCW repository.
5. Add your answers directly on this edit page
   
6. After adding answers, scroll down to the "Propose file change" section
   • In the first input field, enter "Add yourusername to the challenge" (but actually input your Github username.)
   • The body text text is optional. For this challenge, don't worry about putting anything in this area.
   • When finished, click on the green 'Propose file change' button
     
7. After the 'Comparing changes' page loads, click on "Create pull request"
   

• Note: This is a interesting area to focus on. Scroll down and see the changes you have made (highlighted in green) and the red is what has been deleted

8. After the "Open a pull request" loads, you will see what you wrote before (In Propose file change) now in the commit section in the first input area. (Also, if you added anything in the body area, it will show up here as well)
   

• Click on "Create pull request"

8. Challenge Complete!
   

• Wait (we will add your changes ASAP)

Back to top

---

Intermediate and Advanced Route

Materials

• A local or IDE development environment with git installed
  • Most IDE environments have git installed
  • Instructions on how to install git locally
  • Recommended IDE: cloud9

Knowledge/Experience

• Basic knowledge of git and github such as add, commit, push, and pull.
• Know what a Forked project is and how to work within it.
• Familiar with working on a project locally or through and IDE

Steps

1. Fork the project
   • In the repository, click on the fork button in the top right corner
   • This will make a copy of the project and connect it to your account
2. Clone the forked version of the project to your local or IDE environment
   • Once the forked project loads, click the copy to clipboard button from the HTTPS clone url section
   • After you have the url to clone, go to you local or ide environment and run a git clone of the forked repository (code at bottom of this list)
   • Important: Make sure this is a forked copy of the repository, if the url doesn't have your username, you may not have forked properly. If you forked properly, you don't have to push the copy button. You can use the code below and insert your own github username.
   • git clone https://github.com/yourusername/Pull-Request-Challenge.git

3. Make a new branch and name it your Github username

   • git checkout -b yourusername

4. Copy/paste/rename the template.md file to your Github username

   • The template file should not be edited. A new copy of the template.md file with your username will make it easier to merge into the repository.

5. Answer the questions and save it

6. Commit the changes

   • git add -A
   • git commit -m "Add yourusername to the challenge"

7. Push the branch of the forked repository

   • git push origin yourusername

8. Submit a pull request from your forked github repository

[Back to top](#pull-request-challenge)

The end! :) Make sure to "star" the repo if you enjoyed this challenge.