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 you use with Beanstalk, Github, or Bitbucket needs to match the email address of your DoneDone account.
Simple setup with Beanstalk, GitHub, and Bitbucket
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.
Updating DoneDone issues when you commit
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]
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:
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:
- In Progress
- Not An Issue
- Not Reproducible
- Missing Information
- Pushed Back
- Ready For Next Release
- Ready For Retest
- Fix Not Confirmed
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.
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.
- This will mark issue #19 as “Fixed” and add the tag “ui”.
- Issue #23 will be reassigned to email@example.com, the tags “graphics” and “ui” will be added, and the status will be set to “In Progress”.