Integrations

Subversion & Git

Getting Started

DoneDone offers four options to modify issues when committing code to your Beanstalk, Github, or Bitbucket account. Your commit messages can now be used to make updates to issues in DoneDone.

What You Can Do
  • Add a comment to an issue
  • Change the status of an issue
  • Reassign who is fixing the issue
  • Add new tags to an issue

DoneDone maps users via their email address, so the email address associated to your Beanstalk, Github, or Bitbucket repository needs to match the email address of your DoneDone account.

If you are having issues with integrating DoneDone to your Beanstalk, Github, or Bitbucket repository, read our FAQ answer. We’ve listed a few common things that tend to be the culprit.

Simple Setup

To integrate a Beanstalk, GitHub, or Bitbucket repository with a DoneDone project, follow the simple setup instructions found on the “Integrations” section in your DoneDone project. Setup involves logging into your repository and adding a couple bits of information.

Integrations

Updating Issues

When you commit via Beanstalk (SVN or Git), GitHub, or Bitbucket, the commit message will forward to the DoneDone project you specified in the setup above.  Here’s the format you need to provide in your commit messages to update issues in DoneDone:

Your optional commit comment goes here. 
[#ISSUE_NUMBER tags:"QUOTED,LIST,OF,COMMA,SEPARATED,TAGS"]
[#ISSUE_NUMBER reassign:VALID_EMAIL@OF.DONEDONE.USER]
[#ISSUE_NUMBER status:VALID_STATUS]

The comment will be added to all issue numbers specified in each bracketed section that follows. In turn, each bracketed section can specify the action to apply to the specific issue in your project. If you want to include several actions for a single issue, just separate the edits with a space:

Your optional commit comment goes here. 
[#ISSUE_NUMBER status:VALID_STATUS tags:"QUOTED,LIST,OF,COMMA,SEPARATED,TAGS" reassign:VALID_EMAIL@OF.DONEDONE.USER]

If you just want to add a comment to an issue, simply provide the issue number in brackets:

Your optional commit comment goes here. [#ISSUE_NUMBER]

Valid Edits

Each bracketed section must begin with a pound sign (#) followed by a valid issue number. You can then provide any and all of the following case-insensitive actions for the issue:

  • status
  • tags
  • reassign

Available Statuses

The status action, if provided, changes the status of the issue. The same permissions you have to an issue within DoneDone apply to your commits. So, if you are a DoneDone administrator, you can update the issue status to any of the following, at any time. If not, you’ll only be allowed to update to an appropriate status.

The case-insensitive statuses you can provide are:

  • Open
  • In Progress
  • Not An Issue
  • Not Reproducible
  • Missing Information
  • Pushed Back
  • Ready For Next Release
  • Ready For Retest
  • Fixed
  • Fix Not Confirmed
  • Closed

Adding Tags

The tags action, if provided, must be a comma separated list of tags wrapped in quotes. These tags will be added to the existing set of tags tied to the issue. No tags will be removed.

Reassigning a Fixer

The reassign action, if provided, must be the email address of a person on the DoneDone project to whom you wish to reassign the issue.

Limits

You can add a total of 10 of actions in a single commit. If you provide more than 10, only the first 10 will be processed.

Full Example

I fixed the weird glitch with the font that happens in IE7 and IE8.
I also fixed a javascript bug. Lastly, I stubbed in an image for the 
new graphic we want to use so that the designer can create a new one.
[#19 status:fixed tags:"ui"] [#20 status:fix not confirmed tags:"javascript"]
[#23 reassign:designer@wearemammoth.com tags:"graphics,ui" status:In Progress][#24]
Result
  • This will mark issue #19 as “Fixed” and add the tag “ui”.
  • This will mark issue #20 as “Fix not confirmed” and add the tag “javascript”.
  • Issue #23 will be reassigned to designer@wearemammoth.com, the tags “graphics” and “ui” will be added, and the status will be set to “In Progress”.
  • The comment describing the changes will be added to all four issues, including issue #24: “I fixed the weird glitch with the font that happens in IE7 and IE8. I also fixed a javascript bug. Lastly, I stubbed in an image for the new graphic we want to use so that the designer can create a new one.”