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.

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 ;)

Gitting Started

• Learn the Basics of git (greeneg)
• Find the sources for a KDE Project (10% done)
• Read how to push code back to the KDE repositories (25% done)
• Learn how to use git-svn with kde's older svn-based projects. (needs cleanup)

More advanced git usage

Git has many features that older systems like SVN do not have. Some of the trickier things are detailed here.

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

Miscellaneous Pages

• Using kde-qt (done)

Further Reading

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

• 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!)
• git for gnome developers
• the official tutorial introduction to Git