You can use commit hooks to update bugs quickly from commit log messages. That way, you can say things like "Changed X to Y, this fixes BH-123" and it will update your BugHerd bug 123 with that message, and change the state to done. Commit hooks are currently available for GitHub and Bitbucket.
Here's how it works:
- If you reference any valid bug number, preceded by BH- the commit message will be added to that bug. For example: "Some changes related to BH-1"
- Using the word "closes" just before the bug reference, will change the state to closed. Example: "Closes BH-1"
- Using the word "fixes" just before the bug reference, will change the state to done. Example: "Fixes BH-1"
- Using the word "started" just before the bug reference, will change the state to doing. Example: "Started BH-1"
- Using the word "planned" just before the bug reference, will change the state to todo. Example: "Planned BH-1
- You can also use the exact name of the state you want the bug in instead of the phrasing above (backlog, todo, doing, done).
- You can reference multiple bugs at once by separating references with a comma. Example: "Fixes BH-1,2,3".
- You can make multiple references and phrases in the same message. Example: "Fixed BH-1,2. Started BH-3"
Go to the BugHerd project you wish to connect and select commit hook from the project menu.
This will open the commit hook setup screen:
Copy the GitHub Webhook URL from the text box, then open GitHub, go to the project you administer and click Settings. Under Webhooks, click Add Webhook and paste the webhook URL in the Payload URL field. Select the Content Type as 'application/json' and click Save
For Bitbucket, copy the web hook provided and go to Settings > Webhooks.
Give your webhook a title and then paste the Bitbucket webhook URL in to the url field.
Please ensure you have the Active box ticked and click Save when done.
For GitLab, copy the web hook provided and go to Settings > Integrations, tick the `push events` trigger and click save.