Infrastructure/Git

<languages /> <translate> This is the hub page for all information about the use of Git by KDE.

This page is a work in progress where all new Git material is being organised. Most of these sections will eventually be moved to their own pages. Feel free to add stuff.

KDE and Git

This section provides details on using the KDE Git infrastructure.

GitKdeOrgManual is still the primary resource.

KDE Git Configuration

How to configure Git for use with the KDE infrastructure.

Please see the Git Configuration page.

KDE Git Policies

KDE policies on Git. More generic development policies go elsewhere.

KDE Git Recipes

Short recipes for using Git with the KDE infrastructure.

Please see the Git Recipes page.

KDE Git Tutorials

More in-depth instructions in using Git.

• A quick step-by-step guide for getting started

• Creating a patch

Please help filling this section by

• checking the links at the bottom of the page and see which still have valid content
• write tutorials yourself

External Git Resources

Links to useful external sites about Git

Official Documentation

• Links to git official documentation

Git for SVN Users

• The git-svn Crash Course

Git books

• Pro Git - An easy to understand book on git (CC licensed).

• The git community book, also as a pdf

Tutorials

• Git Magic - A good intro to git (in several languages!)

• The Git Parable

- Essential reading if you want to truly understand git.

• Git Screencasts

Cheat Sheets

• Quick reference

• Illustrated git cheat sheet

(broken image, get it from Media:Zrusin-git-cheat-sheet-medium.png)

Documentation Changes

KDE Documentation Review

Existing Pages For Review

Existing KDE pages about Git, SVN, and/or buildinga KDE that need to be revised. When revising pages try to split the generic development and revision control policies separate from Git specific stuff. Do not refer to "the KDE Git Repository" but instead the "KDE Code Repository". Lots of small simple pages that are less daunting to newbies and can be linked to from multiple locations are preferred to massive walls of text.

Keep:

• Basics

• Git-svn

• Kde-qt

• The Amarok Git Tutorial

On community.kde.org:

• Git-KDE Manual

• Git Workflow Agenda

• Git Workflow Agenda, Steve's Idea

On techbase.kde.org:

• Getting Started

• Build KDE 4

• Build KDE 4.x

• Prerequisites

• Subversion on Windows

• Increase Productivity with Scripts

• Kdesrc-build

• Anonymous SVN

• Subversion with KDE

• Using an IDE with KDE 4

• SVN Commit Policy

• SVN Guidelines

• Development Tools

• Git Recipes

• Decoding Git

• Git with Rekonq How-to

• Subversion

• Move to Git

• Steps to Move

• Get a SVN Account

• First Steps with your KDE SVN Account

There are also numerous other pages referring to "the KDE SVN/subversion repositories" which should be replaced with the generic "KDE code repositories".

There are also numerous translated pages which will need to be updated once the original pages are completed.

New Page Structure

• Getting Started

• Getting_Started/Build

• Getting_Started/Build/Environment

• Getting_Started/Build/Requirements

• Getting_Started/Build/Q

• Getting_Started/Build/KdeSupport

• Getting_Started/Build/Windows

• Getting_Started/Build/Mac_OS_X

• Getting_Started/Run/Shell

• Getting_Started/Run/Nested_Session

• Getting_Started/Run/Full_Session>

</translate>