You don't need to manually update your Waffle board - let WaffleBot do it for you!

Current WaffleBot's automatic tracking features include:

  • Automatically moving issues into your Work Started (default: In Progress) column
  • Automatically moving issues with pull requests to your Code Review column
  • Automatic moving issues to your Done column when the pull request is merged

Let's go through an example:

1. Create a Branch, Automatically Assign, and Automatically Move to In Progress

We've created a new issue on one of our test boards. For the purposes of this walkthrough, card #12 is what we'll work with.

Next, we created a branch that references issue #12 in the branch name.

By referencing the issue in the branch name, the issue is automatically moved into the 'In Progress' column on the Waffle board and the branch creator is assigned to the issue.

2. Create a Pull Request, Connect the Issue, Automatically Assign, and Automatically Move to the Review Column

Next, we made a change in the README and created a Pull Request (PR) that references issue #12 using GitHub's Closing Keywords.

After the PR was created, the WaffleBot automatically moves issue #12 into the 'Needs Review' column, with the associated PR #13 nested below.  You can also see real-time pull request merge status, pull request review status, and status checks on cards.

3. Merge the Pull Request, Automatically Move to the Done Column

Next, we merged the PR in GitHub.

After the PR was merged, the WaffleBot automatically moved the issue to the 'Done' column.

When you view the issue in GitHub, you'll see all of the automatic actions the WaffleBot to track your work. In the example below, you'll see that WaffleBot assigned the user, moved issue #12 from 'Ready' to 'In Progress'. You'll also see that when the issue was moved from one column to the next, the previous column label is removed by the WaffleBot and it also adds the new column label.

You can customize the columns on your Waffle board and customize the automation rules used by WaffleBot.  Check out the Waffle Automation Cheatsheet for a complete list of WaffleBot's automation commands.

Did this answer your question?