Basics[edit | edit source]
Forget what you know about any other VCS.
Git is fully featured when used as a command line tool.
Usage for hardware projects[edit | edit source]
All VCSs can handle text & binary files but cannot merge binary ones.
Git has a fairly steep learning curve, other version control systems might be more intuitive but are not as widely used. Only a few commands are needed, e.g. status, add, remove, commit, push, etc. and then usage is simple. Git works locally, a remote server is optional. When using a remote server, it can be located anywhere accessible via HTTP or SSH.
A repository is a nest of folders for e.g. projects and libraries. Then git is used to commit or push changes. This way git takes care of all the tracking, removing the need for keeping multiple versions of a project and any point in the development can be returned to.
GitHub, GitLab and other sites are git repository hosting service, they offer the functionality of git as well as adding their own features. Having a centralized repository allows people to collaborate on projects.
Setting up a repository[edit | edit source]
To create a repo within an existing project folder, first cd to the root project folder and then execute the git init command.
cd /path/to/your/existing/code git init
Github[edit | edit source]
GitHub lets you complete many Git-related actions without using the command line. Images in a GitHub repository can be viewed in the browser and visually compared in different modes. To make use of this feature export schematic and PCB layouts as images.
References[edit | edit source]
- ^ Git homepage
- ^ Version Control Software in 2014: What are Your Options?, Shaumik Daityari, 22 April 2014
- ^ a b c d PCB version control and notes, EEVblog forum, May 2015
- ^ Git for ages 4 and up
- ^ Git documentation.
- ^ Version control systems for hardware projects?
- ^ How to use Git?, Stack Overflow
- ^ Industry Practices for Schematic Design?
- ^ Version-Controlled Hardware Design with EAGLE by Jordan Schaenzle, 19 Jan 2015.
- ^ GitHub, Wikipedia
- ^ Setting up a repository, Atlassian.com
- ^ GitHub Help
- ^ Rendering and diffing images, GitHub help
[edit | edit source]
- Git downloads for Mac OS X, Windows, Linux and Solaris
- Pro Git Book – An open source book on Git by Scott Chacon and Ben Straub, Apress, 2014, ISBN 1-4842-0077-2
- Git documentation
- Git, Wikipedia
Cheat sheets[edit | edit source]
Beginners guides[edit | edit source]
- git – the simple guide – no deep shit!
- Git Beginner's Guide for Dummies
- Think Like (a) Git
- A Visual Git Reference
- Git for beginners: The definitive practical guide
Github[edit | edit source]
|This article is a stub. You can help the Synth DIY Wiki by expanding it.|