# Kit and Git

Kit is built upon git, although for most types of assignments students, and
even graders, don't have to know anything about git.

The exception for students is if you are expected to submit your work as a
git repository.

For graders there's a second exception.  If you want to download all of the
submissions for an assignment at once, rather than viewing or downloading
the files one-by-one, then you will need to use 2 or 3 of the simplest git
commands.

## Getting Started

To use git, you should start with a couple of very simple configuration
commands from a Unix/Linux/bash command line.  You only need to do this once
on your computer, although if you switch to a different computer later you
will need to do it again on that machine.

The hyphens or dashes in the commands below are double-dashes, e.g.,
dash-dash-global, even if they look like just a single dash.

    git config --global user.name "Alyce Brady"      (use your name!)
    git config --global user.email "abrady@kzoo.edu" (use your email address!)
    git config --global color.ui true                (I recommend this)
    git config --global --list                       (shows your config info)


If you want to really learn more about git, some useful starting points are:

  - https://git-scm.com/book/en/Getting-Started-Git-Basics  
       (**Key:** the subsection under 1.3 with the heading The Three States)
  - https://git-scm.com/book/en/Getting-Started-Installing-Git
  - https://git-scm.com/book/en/Getting-Started-First-Time-Git-Setup

As you learn more, more of the `git-scm` book will be useful to you as well.
There are also many other online resources about git.