Archive:Development/Tutorials/Git

Although KDE is currently using SVN, we're working on moving to git. Also, a growing number of developers are using git-svn to contribute to KDE.

There are many resources available for learning about Git; the techbase pages below provide a kde-specific introduction, based on the most common tasks. After those links is a list of external documentation we've found useful.

Pages

Note: these pages are not complete. help would be appreciated. :) The idea is to provide information in more of a 'recipe' style than 'tutorial': first provide simple commands that people can use Right Now for straightforward tasks, then links to other pages or external git documentation for the tricky things.

Amarok has their own git tutorial, which has a fair amount of overlap with these git pages (we're copying from them ;)

Getting Started

• Using kde-qt (done)
• Using git-svn with kde's svn (needs cleanup)
• Accessing or setting up a KDE project on Gitorious.org (25% done)
• Basic git commands (greeneg)
• Contributing to KDE projects on gitorious (85% done)
• Handling common git error and information messages (todo)
• How to specify git file and directory version numbers (todo)
• How to organise branches, do comparisons between branches, minimize recompilation when switching branches, ... (todo)
• git.kde.org manual

Intermediate/Advanced

• things to avoid / best practices (10% done)
• Taking advantage of git's features (20% done)
• useful recipes

Further Reading

If you want to learn more about git, see the following resources:

• Illustrated git cheat sheet - Overview of the most commonly used commands
• Another git cheat sheet - Quick reference
• git <-> svn crash course - Maps git commands to svn commands
• The Git Parable - Essential reading if you want to truly understand git.
• Git Magic - A good intro to git (in several languages!)
• The official tutorial introduction to Git
• Pro Git - An easy to understand book on git (CC licensed).