Get

...

Git

Follow the instructions for your environment here:
http://git-scm.com/

...

Sign-up for a GitHub account.

http://codegithub.google.com/p/msysgit/

Linux

$ sudo apt-get install git-core

Essential git commands

checkout, branch, clone, remote, rebase

Initial Simplified Sprinting Workflow

Fork

Accessing Pentaho code hosted on GitHub

All projects migrated to Git are hosted on the Pentaho organization: https://github.com/openpentaho/Recipes to your Github account.

Clone to local directory
git clone YOUR_FORK_URL

Configure your "origin" remote to pull from the openpentaho repository, yet push to your fork.
git remote set-url origin git@github.com:openpentaho/Recipes.git
git remote set-url --push origin YOUR_FORK_URL

Go ahead and do your work in the "master" branch
Make some changes to the Margarita recipe, add a new one, whatever. Add the changes and commit
git commit -a -m "My Awesome Commit Message"

Refresh "master" with latest changes from upstream
git pull --rebase

Push your changes up to your github location
git push

Issue pull request for your work from within github

When notified that your pull request has been processed do the following:
Refresh "master" with lastest changes:
git pull --rebase

Github

fork

...

pentaho

Contributing code

Pentaho has no special procedures for working with our GitHub repositories. Follow the general workflow and instruction on GitHub:
https://help.github.com/

When you're ready to submit code with a Pull Request, create a Jira case and use the case number in your commit messages, e.g. "JIRA-1234 adding new functionality". When submitted update the Jira case with a link to the pull request on GitHub.