< Infrastructure | GitRevision as of 12:39, 5 June 2011 by Odysseus (talk | contribs) (→Create a Work Branch)(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff) Contents 1 Simple KDE Git Workflow 2 Set-up 2.1 Configure Git 2.2 Clone your repository 3 Basic Actions 3.1 Create a Work Branch 3.2 Commit Your Changes 3.3 Push Your Changes 4 Local Bug Fixing 5 Local Feature Development 6 Remote Feature Development Simple KDE Git Workflow This Git Workflow is designed to be followed by a new Git user who needs a simple workflow for bug fixes and new features in a manner similar to the old SVN workflow. Note that each module may choose to adopt a more complex workflow and you should check with your modules maintainers if this is the case. The worked examples given will be for an imaginary app called KFoo in a git.kde.org repository called 'kfoo'. Set-up This section documents how to set up Git and your code repository for development. Configure Git Follow the KDE Git Configuration page. Clone your repository You need to copy your repository from git.kde.org into your local KDE source directory. In Git this process is called cloning. To clone your project repository: cd your/source/dir git clone kde:<project> In our KFoo example: git clone kde:kfoo See the KDE Build Environment page for advice on structuring your source directory. If you have a slow internet connection then you may prefer to download a snapshot tarball to bootstrap your clone. You can copy the required command from the projects.kde.org Repository page for your project, but it will be of the form: wget -c http://anongit.kde.org/<project>/<project>-latest.tar.gz Basic Actions This section documents basic actions that are performed within your workflow. See also the KDE Git Recipes page. Create a Work Branch By default when you first create a repository clone there is only a single local branch called 'master'. It is not good practice to do development in master, it is better kept clean for reference. Instead all work should be performed in a new local branch, even bug fixes. To see what local branches you have: git branch To see all local and remote branches: git branch -a To create a new local branch: git branch <new-branch> git checkout <new-branch> This will create a new branch based on whatever local branch you were already in, i.e. that includes all the history of the original branch, which can be useful in building a hierarchy of dependent changes. You may prefer to base your new branch on a remote branch such as the master branch of the central repository so you can integrate any new development. This is called 'tracking' and is recommended for most branches: git branch --track <local-branch> <remote-branch> For our KFoo example: git branch --track new-bar-feature origin/master Commit Your Changes Push Your Changes Local Bug Fixing This example workflow is for locally fixing bugs in stable and unstable branches and pushing them to the central repository. This workflow is only recommended for small fixes or where you are the only developer on a project. Local Feature Development This example workflow is for locally working on new features in unstable branch and pushing them to the central repository. This workflow is only recommended for small features or where you are the only developer on a project. Remote Feature Development This example workflow is for working on new features in a feature branch hosted on the central repository. This workflow is recommended for larger features or where there are many developers on a project. Retrieved from "https://community.kde.org/index.php?title=Infrastructure/Git/Simple_Workflow&oldid=52022" Content is available under Creative Commons License SA 4.0 unless otherwise noted.