Git guide

Topics

Getting started with Git: if you have never played with Git before, this is for you!
Git IzPack workflow: how one can use Git to work on IzPack.

IzPack Git repositories

The "blessed" IzPack repository is available from https://github.com/izpack/izpack.

Anonymous access:
- via the Git protocol: git@github.com :izpack/izpack.git
- via HTTP: https://github.com/izpack/izpack
Developer access:
- ssh://git@github.com:izpack/izpack.git (you will need to upload a SSH public key to your account details).

Pull requests on GitHub

A quick and efficient way to collaborate with an IzPack developer that has a repository on GitHub is to:

fork his/her repository, and
send pull requests to propose your changes.

Pull requests on GitHub are really useful as they make code reviews painless!

Funny tip if you are a Subversion fanatic: GitHub repositories can be accessed read-only from Subversion.

Historical considerations

A complete Git conversion of the old Subversion repository can be found at http://github.com/jponge/izpack-full-svn-history-copy (keep in mind that because it is based on the full repository, there are no branches and tags informations, just a linear branch which maps the Subversion revisions).

IzPack first used CVS, in 2004 it switched to Subversion. It switched again, this time to Git, in 2010.