make.opendata.ch wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Getting started with Git ======

{{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.

**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. If everyone uses one place to store their notes, code, sketches and data, 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 lately, what they have been doing, and even the line-by-line changes to every file. All at a glance.

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>

While we sometimes use GitHub's built-in wikis to document our projects, we still make sure to [[project:home|add a project page]] to this wiki to give our efforts extra visibility, and keep the projects going at least here in the Swiss open data community. That's where the widget above comes in, to tie the two together.

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/index.de.html|git - Der einfache Einstieg]]
  * [[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 :)