How to do Skills Assessments from GitHub Classroom

Getting Started

Before you start, you’ll need a terminal where you’ve SSH’d into Vagrant.

To SSH into the Vagrant shell:

Open a terminal window and cd into your ~/vagrant directory
```
$ cd ~/vagrant
```
Then run vagrant ssh
```
$ vagrant ssh
```

Clone Your Repo

First, you’ll use git clone to clone your assessment repository from GitHub.

What does git clone do again?

Let’s say there’s some code on GitHub that you want to download onto your computer. git clone makes it easy to do just that.

The git clone command does a couple things:

It’ll create a new folder in your current working directory
Then it’ll download all the files in the repository into that new folder
And not just that but it will also include the repository’s Git history (which may include prior commits, amongst other things)

To clone your assessment repository:

Get your repo’s clone URL. Click on the green button (see the screenshot below) and copy the URL that appears
In Vagrant, navigate to ~/src. To run git clone, type git clone, then a space, then paste the URL you copied from GitHub, and press Enter.

For example, if your URL is https://github.com/hackbrightassessments/skills-1-hackbrighter.git, you’ll run:
```
$ cd ~/src
$ git clone https://github.com/hackbrightassessments/skills-1-hackbrighter.git
```
Navigate to the directory created by Git. For example:
```
$ cd skills-1-hackbrighter
```

Work on the Assessment

READ THE WARNING BELOW BEFORE YOU START WORKING.

Make sure you’ve updated your Git configuration with your name and email

You can check the name and email associated with your Git configuration by running:

$ git config --global user.name
$ git config --global user.email

The commands above should output your name and email. If you see nothing or if you see the wrong name and email, you need to update your configuration.

Set your name and email by running the commands below. For example, if your name is Hackbright Student and the email associated with your GitHub account is student@hackbrightacademy.com:

$ git config --global user.name "Hackbright Student"
$ git config --global user.email student@hackbrightacademy.com

Open the assessment’s instructions to start working on it. You’ll find a link to the assessment instructions on your GitHub repo’s homepage or in README.md.

Since you cloned your repo into ~/src, you’ll be able to access the starter code and work on it using your code editor of choice!

Commit and Push Your Work

Try your best to commit often and commit as you write your code. We highly recommend pushing your code (which will upload your work to GitHub) right after you make a commit. That way, GitHub will always have the latest version of your code.

To commit and push your work:

Run git status to verify that you’re happy with the files you’re about to commit
- In most cases, you will not need to add additional files to Git, but if you do, add the file with git add

Commit your work with git commit

$ git commit -am "Your commit message here"

Now you can push all your changes
```
$ git push
```

That’s all you need to do to submit your work — just commit and push your changes to GitHub!

Remember, we will only grade your work based on the latest commit you created before the deadline. For full-time programs, the deadline is usually 9:00 PM on Sunday.