This is an old revision of the document!
Table of Contents
Git is a piece of software called a “version control system” or “revision control system”.
The electrical team is using git for our work with schematics and printed circuit board design. The software team is using it for robot code. Both teams are creating and changing many computer datafiles, which they need to share and track. Version control systems make it easy to keep track changes to files, to back up to old versions if a mistake is made, and to coordinate changes among many users.
Github is an online service that provides two main things (an lots of others): git repositories “in the cloud”, and a bunch of web features built on top of git. FIRST gives teams good githup accounts, so we're using it.
Before doing anything, sign up with github (create a username and password, and join the Eastbots organization: https://github.com/Team-4795. (does someone have to invite team members so they get permission on Team-4795?)
Installing Git
If you're using linux, git should be available easily with the software package manager in your linux system. We found a good windows download here https://git-scm.com/download/win (Ilena, is this the one we put on yoru computer?)
Git basics, Steve's version
git clone
Clone is used to copy an existing repository - typically to get your own local repository from the “parent” one in the github cloud. You follow the clone command with the URL or path to the existing repository, for example:
git clone https://github.com/Team-4795/pcboards-2018.git
to put a copy of the pcboards-2018 tree onto your own computer. Get the link to the existing repository from the green “clone or download” button in the repository's github page.
- git pull
- git status
- git add
- git commit
- git push
References
- official git documentation and tutorial: https://git-scm.com/book/en/v2/Getting-Started-Git-Basics