Next revision | Previous revision Next revisionBoth sides next revision |
information:github [2013/03/10 13:38] – created loleg | information:github [2013/09/14 11:49] – loleg |
---|
====== Getting started with GitHub ====== | ====== Getting started with Git ====== |
| |
[[http://github.com|GitHub]] is one of the most popular Internet sites for hosting projects, usually software projects, but not only - really anything you can save in a file on your computer you can share and collaborate on with other people on GitHub. The name comes from [[http://en.wikipedia.org/wiki/Git_(software)|GIT]], a widely used system for keeping track of changes to text files. | {{http://octodex.github.com/images/benevocats.jpg?120 |}} |
| If you browse the projects hosted here, you'll notice many of them have source code links to [[http://github.com|GitHub]]. This is one of the most popular Internet sites for hosting projects, usually software projects, but not only - really anything you can save in a file on your computer. The name comes from [[http://en.wikipedia.org/wiki/Git_(software)|GIT]], a widely used system for keeping track of changes to text files. It was specially designed for complex software projects, and works well at any scale. If you're a programmer, chances are you've used it by now. If not, imagine a Dropbox with some additional features to make working on projects online more effective and fun. |
| |
It was specially designed for complex software projects, and works well at any scale. If you're a programmer, chances are you've used it by now. If you're not, imagine a Dropbox with some additional features to make working on projects online more fun and effective. | **You don't need to be a programmer to use top notch Internet collaboration tools!** We like GitHub especially because it's easy to use, accessible from everywhere, and is social in the way we're already used to. |
| |
We decided to standardize on GitHub to make hackathons run more efficiently. Anyone can create an account, configure their computer, and within minutes make contributions to projects in a way that is really transparent and easy to follow whether you're sitting next to your team members, or half way around the world. | If everyone uses GitHub, hackathons can run more efficiently. You can quickly create an account, configure your computer, and within minutes make contributions to projects in a way that is really transparent and easy to follow - whether you are sitting next to your team members, or contributing from half way around the world. |
| |
For example, check out the list of [[https://github.com/OpendataCH/Transport/commits/master|latest commits to the Transport API]] project. You can see who has been working on it, what they have been doing, and even the line-by-line changes to every file. | For example, check out the list of [[https://github.com/OpendataCH/Transport/commits/master|latest commits to the Transport API]] project. You can see who has been working on it lately, what they have been doing, and even the line-by-line changes to every file. All at a glance. |
| |
Once you have a GitHub project, you can use this syntax to add a beautiful widget to your wiki page here: | Since GitHub is also a social network, it is easy to follow projects, people and groups and receive the freshest info on a dashboard. Once you have a GitHub project, let us know and we will fork it to the [[https://github.com/OpendataCH/|OpendataCH group]] to give it extra visibility. You can also use this syntax to add a beautiful widget to [[project:green_street|your wiki page]]: |
| |
<code><GITHUB myusername/my-repository></code> | <code><GITHUB myusername/my-repository></code> |
| |
If you're completely new to GIT, have no fear. There's an excellent guide for beginners which will introduce you to the main features quickly. | If you're completely new to GIT, have no fear. There are several high quality GUIs (like [[http://www.sourcetreeapp.com/|Atlassian Sourcetree]] and GitHub's own program for [[http://mac.github.com/|Mac]] and [[http://windows.github.com/|Windows]]) that make it a point-and-click excersize, and excellent guides for beginners which will introduce you to the main advanced features quickly: |
| |
[[http://rogerdudler.github.com/git-guide/|git - the simple guide]] | * [[http://rogerdudler.github.com/git-guide/|git - the simple guide]] |
| * [[http://rogerdudler.github.com/git-guide/index.de.html|git - Der einfache Einstieg]] |
[[http://rogerdudler.github.com/git-guide/index.de.html|git - Der einfache Einstieg]] | * [[http://rogerdudler.github.com/git-guide/index.fr.html|git - le petit guide]] |
| |
[[http://rogerdudler.github.com/git-guide/index.fr.html|git - le petit guide]] | |
| |
And feel free to [[http://make.opendata.ch/forum|reach out to us]] if you have any questions, we'll be very happy to help :) | And feel free to [[http://make.opendata.ch/forum|reach out to us]] if you have any questions, we'll be very happy to help :) |