Skip to content

One-Time Setup

You only need to do this once. After this, contributing will be much easier!

  1. Download and install Git from git-scm.com/install

    • Windows - Download the installer and run it. Click “Next” through everything, the defaults are fine.
    • Mac - Open Terminal and run: xcode-select --install
    • Linux - Open Terminal and run: sudo apt install git (debian based) or look into options in your distro’s package manager.

    To confirm it downloaded, open a terminal and run:

    Terminal window
    git --version

    You should see something like git version 2.x.x.

  2. Go to github.com and Sign Up.

    • Use any email you have access to
    • Pick a username you’re happy with — it’ll be visible to other club members
    • The free plan is all you need

    Once you’re signed up, send your GitHub username to a club president so they can add you to the club’s GitHub organization.

  3. Open a terminal and run these two commands, replacing the examples with your own info:

    Terminal window
    git config --global user.name "Your Name"
    git config --global user.email "your@email.com"

    Use the same username and email you signed up to GitHub with.

  4. Once a club president adds you to the organization, you’ll get an email invitation from GitHub. Click Accept invitation to join the organization and gain access to the private repos.

  5. “Cloning” means downloading the project to your computer so you can make changes to it.

    You can find the repository URL from the organization’s page. Then run:

    Terminal window
    # Clones the project to a folder with the same name as the repo
    git clone https://github.com/[club-org]/[repo-name].git
    # Moves your terminal's working directory to that
    # of the folder just made, so your commands affect it.
    cd [repo-name]

    You now have the full project on your computer!