Using the Clubhouse GitHub Integration with Commits

For smaller Stories like hot fixes, you can associate an individual commit with the Story. Typically, these commits are pushed directly into “Master” or on to an intermediary branch like “Develop”. The mechanism for doing so is similar to associating a feature branch. You can simply use the Story URL<MYORG>/story/<story number>/<story-name> or bracketed text  [ch###] where “###” is the Story ID anywhere within the commit message.

Git Commit Clubhouse

You can also do this in the GitHub UI by selecting "Create a new branch from this commit and start a pull request" and then pasting the branch information there as shown below).

Github Commit Changes

Changing Your Workflow State with GitHub Commit Messages

It is also possible to change the workflow state of a Story via additional bracketed text commands within a commit message. To move the story to a "Finished" workflow state (as defined in your organization’s workflow), include your organization's designated finish verb in brackets in the last commit that you push (click here to read more about setting up and using verbs and workflow states in Clubhouse ). 

Git commit Clubhouse Story

Clubhouse will also add you as Owner to an unowned Story when GitHub activity is detected and all merge events in GitHub handlers will affect commits as well as branches. 

Associating Multiple Stories with a Single Branch using Git Commits

Branches can be associated with multiple stories using commit messages to . Just add the Story numbers with the prefix `ch` in brackets to the commit message. 

For example:  git commit -m "Fixing this [ch123][ch234][ch345]"

Disassociating Commits from a Clubhouse Story

Commits can be removed from Clubhouse Stories by clicking on the trash can icon next to the commit within the Story:


Re-associating Commits to a Clubhouse Story

Commits can be re-associated with Clubhouse Stories by clicking the "Restore" button next to the commit in the Story's Activity section:


Moving Stories Back

The Clubhouse GitHub integration is designed to move your Stories from unstarted to completed. As such, if you find you need to move a Story back to an earlier workflow state you will need to do so in the Clubhouse UI.

Have more questions? Submit a request
Powered by Zendesk