{{lastupdated_at}} by {{lastupdated_by}}

{{>toc}}

h1. Git workflow for GammaLib

h2. Summary

Any contributions to the GammaLib package, whether bug fixes, improvements to the documentation, or new functionality, can be done via pull requests. Pull requests are issued by changing the status of a "GammaLib issue":https://cta-redmine.irap.omp.eu/projects/gammalib/issues to _Pull request_.

As developer, you have two options for contribution code to the project:
* use the central GammaLib repository "@https://cta-git.irap.omp.eu/gammalib@":https://cta-redmine.irap.omp.eu/projects/gammalib/repository
* use a fork of the GitHub GammaLib repository "@https://github.com/gammalib/gammalib@":https://github.com/gammalib/gammalib

Which of the two to pick is a matter of taste. If you don't know which to pick, use the irap one.

h2. Getting started with git

The only absolutely necessary configuration step is identifying yourself and your contact info:
<pre>
$ git config --global user.name "Joe Public"
$ git config --global user.email "joe.public@gmail.com"
</pre>

*Please make sure that you specify your full name as @user.name@, do not use your abbreviated login name because this makes code modification tracking more cryptic.*

In case that you get 
<pre>error: SSL certificate problem, verify that the CA cert is OK.</pre>you may add
<pre>
$ export GIT_SSL_NO_VERIFY=true
</pre>before retrieving the code. Alternatively, you may type
<pre>
$ git config --global http.sslverify "false"
</pre>which disables certificate verification globally for your Git installation.

The following sections cover the installation of the git software, the basic configuration, and links to resources to learn more about using git. If you use GitHub, you may also check the "GitHub help pages":https://help.github.com/ which offer a great introduction to git and GitHub.
* [[Installing git]]
* [[Configuring git]]
* [[Using SmartGit]]
* [[Git resources]]


h2. Using the central GammaLib repository

The following sections describe the configuration and the workflow for the central GammaLib repository.

* [[Central repository configuration]]
* [[Central repository workflow for developers]]
* [[Central repository workflow for maintainers]]


h2. Using GitHub

The following sections describe the configuration and the workflow for the GitHub GammaLib repository.

* [[GitHub repository configuration]]
* [[GitHub repository workflow for developers]]
* [[GitHub repository workflow for maintainers]]