Git is a distributed control version system, and it is widely used for maintaining source code in opensource software projects like Gramps. Git can track changes to any text file (not only source code), so may be used also to maintain text-based translation files. Thanks for your interest in helping translate Gramps. = Install Git =Download and install Git for your operating system from: https://git-scm.com/downloads = Configuration of Git = You will need to Configure Git so that Git includes your name and email address in the Git messages known as ''commits''.  To configure them, use the following commands:

git clone git@<nowiki>https://github.com:/gramps-project/gramps.git </nowiki> Gramps

git checkout -b gramps50 gramps60 origin/maintenance/gramps50gramps60

There are two main workflows. The basic recommend one is that translators should create a pull request, for those translators new to Git and this will allow their contribution to be checked before it is pushed to the repository. The other is the simple workflow is simplerfor developers, but is only available to developers that have write access to the repository. Otherwise translators should , otherwise please create a pull request. == Creating a pull request == You first need to make a copy of the Gramps repository in GitHub this is referred to as creating a Fork. This may also be preferred by translators who are new To do this, go to Git the Gramps repository page, https://github.com/gramps-project/gramps then login, and would their contribution checked before it click on the "Fork" button. Create a remote to access your Fork:  git remote add myfork <nowiki>https://github.com/</nowiki>''<username>''/gramps.git where ''<username>'' is you GitHub username. Create a branch to work in:  git checkout -b xx gramps60 Now edit the po file using your favorite method and once complete. Commit your changes: git add po/xx.po git commit -m 'Update xx translation' You can update the ''gramps60'' branch at any time.  git checkout gramps60 git pull You rebase your working branch on the ''gramps60'' branch at any time.  git checkout xx git rebase gramps60 When you are ready to make a pull request, push your translation to your fork: git push myfork xx Now create a pull request within GitHub. If you have recently pushed a branch to your fork, then GitHub will highlight this when you visit the repositorypage, and give you an option to create a pull request. Otherwise click on the "New pull request" button. Make sure that you select "gramps60" as the base branch.

== Basic Simple workflow for developers == This simple workflow is for developers, that have write access to the repository, otherwise please create a pull request.

git checkout gramps50gramps60