What it does

1. When a pull request and/or issue is created in a git repository that is configured with gitbot, gitbot will:

   • Create a Pivotal Tracker story in the configured Pivotal Tracker project
   • Post a comment to the github issue with a link to the Pivotal Tracker story

2. Different states of the Pivotal Tracker story will update the github issue/pr with an appropriate label:

   • unstarted → unscheduled
   • moved to the backlog → scheduled
   • started → in progress
   • delivered → delivered
   • accepted → accepted

3. Similarly, different actions of a github issue/pr will trigger actions in the associated Pivotal Tracker story:

   • If the github issue/pr is closed, a comment will be left on the Pivotal Tracker story saying it has been closed and who closed it. The Tracker story will also be finished and updated with the label 'closed-in-github'

4. If a comment as been made in an issue or pr, the associated Tracker story will be updated with the label 'new-activity'

Flags

• You can opt-out of having stories created for PRs that have a Pivotal Tracker Story Id in their description by using ignore_prs_with_story: true
• You can opt-out of having comments added to your repo by using post_comment: false