Create development branches in the main project and the sub-module. I'll use the branch "dev" here but this is arbitrary. The branch name should represent the development topic you intend to work on.

+

Create development branches in the main project and the sub-module. I'll use the branch "modal" here but this is arbitrary. The branch name should represent the development topic you intend to work on. Also am I assuming here that you want to develop off the master branch. There my be scenarios however where it might be more practical to develop off another developer's branch. In that case you can replace "official/master" by any other remote repository you want to base your work on.

Intro

This is the official process to check out OMP with the PKP library as a sub-module.

Create github.com user

Go to github.com and create a user account. Log in to your user account.

Delete existing personal forks

First you have to delete existing personal forks of omp/pkp-lib if you have cloned these repositories before. You obviously shouldn't do this when there are still changes in there you don't have in other locations!

Add the official repository

The 'official' respositories can be compared to the role that PKP's old CVS repositories used to fill. Adding the official branch allows you to synchronize your code with the rest of the team, and should be pulled from before creating a patch or making a commit.

Create development branches

Create development branches in the main project and the sub-module. I'll use the branch "modal" here but this is arbitrary. The branch name should represent the development topic you intend to work on. Also am I assuming here that you want to develop off the master branch. There my be scenarios however where it might be more practical to develop off another developer's branch. In that case you can replace "official/master" by any other remote repository you want to base your work on.

You may get merge conflicts, if the repository you pull from did not merge in all changes from CVS already. See man git-merge for more info on how to solve merge conflicts. If you want to use another developer's code without merging it into your branch, you'll want to pull their branch onto a clean branch--Switch to the master branch (use 'git stash' if you have uncommitted changes you want to save) and create a fresh branch, e.g. execute: