Skip to content

Guide to Git and Github

mcli edited this page Oct 17, 2016 · 2 revisions

Git and GitHub

Git is a distributed version control system that allows developers to develop in parallel and share code changes with each other. GitHub is a service that functions as a central git server and provides a web interface to access and organize different git repositories. This page guides developers through how the Irvine CubeSat development process uses Git/GitHub.

Find more information about git and github at Resources for Learning Git and Github.

Git Installation

If git is not available on your system, install it using the apt-get utility:

$ sudo apt-get install git

GitHub account

Each developer should have a personal github account. If you don't have one, sign up at GitHub. Inform the Irvine CubeSat Admin (CubeSatAdmin at iusd.org) of your account name and your team so that you can be added to the Irvine CubeSat Organization in GitHub and be allowed to commit changes to Irvine CubeSat projects.

Getting Started

Fork JumpStart

Forking a project means creating your own server-based project on the github server. A forked project is owned by you and you may commit/push to it without affecting other users. At https://github.com/irvinecubesat/jumpstart, click on the fork button on the upper right hand corner of the page.

Clone JumpStart

Cloning JumpStart copies the repository from GitHub onto your own computer where you can then do your local development:

$ git clone https://github.com/<username>/jumpstart

Branches

Each project has a master branch and a dev branch. Development should normally be on dev or a personal branch. When changes are ready to be released, they are then merged into master.

Clone this wiki locally