Differences

This shows you the differences between two versions of the page.

--- information:github [2013/03/11 15:27] – loleg
+++ information:github [2013/09/14 11:53] (current) – loleg
@@ Line 1: / Line 1: @@
-====== Getting started with GitHub ======
+====== Getting started with Git ======
-{{http://octodex.github.com/images/benevocats.jpg?120 |}} [[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. 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 effective and fun.
+{{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.
-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 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.
+**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.
-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]]:
+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.
-<code><GITHUB myusername/my-repository></code>
+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]]:
-If you're completely new to GIT, have no fear. There are excellent guides for beginners which will introduce you to the main features quickly.
+<code><GITHUB myusername/my-repository></code>
-[[http://rogerdudler.github.com/git-guide/|git - the simple guide]]
+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.
-[[http://rogerdudler.github.com/git-guide/index.de.html|git - Der einfache Einstieg]]
+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/index.fr.html|git - le petit 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.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 :)