What is GitHub?
GitHub (https://github.com) is a hosting service for software projects that use the Git revision control system.
Why should I try it out?
Our integration with GitHub allows users to associate commits in GitHub with story cards in AgileZen. This lets the team stay up to date on the latest development work and view a history of commits for each story.
How do I set up the AgileZen integration in GitHub?
Before you start, you'll need two things from AgileZen:
AgileZen API Key and AgileZen Project ID (the one you want to associate with the repository)
Minimum API Access level Required: Read/Write
Your AgileZen Project ID can be found in the project's URL
Now you are ready to set up the AgileZen integration in GitHub!
Log into your GitHub account at https://github.com
Next, go to the repository that you want to associate with your AgileZen project
Click on the 'Admin' button
Then, select 'Service Hooks'
From the list, select AgileZen
Enter your API key and project ID
To show only changesets from specific branches, list them here
otherwise leave blank.
(if listing multiple branches, separate by a space)
Click the 'Update Settings' button
To have your changesets shown on your AgileZen story card, you
will need to refer to the story ID in your commit message using the
Example: git commit -m "Test commit message on story #303"
When you look at the corresponding story card in AgileZen, you can now see the changeset is available
Click on 'changeset' to see a list of your commit messages associated with that card
If you list multiple story card IDs in your commit message the commit will show on all story cards referenced (list with a character/word between IDs while keeping a space in front of the story ID such as ", " or "and ")
Example: git commit -m "Test commit message on story #123,
Example: git commit -m "Test commit message on story zen-123 and zen-124"
If you have notifications setup, you will receive notifications when commits are sent