GitHub

Link Pull Requests to issues: move the state and attach the PR automatically.

The GitHub integration connects your repositories’ activity to Hilbana issues through a GitHub App.

What it is

Connected in Settings → GitHub (admins only): you install the GitHub App on your organization or account and they’re linked. The page shows the installation and its repositories.

What it’s for

When you work a Pull Request whose branch contains an issue’s identifier (for example drapps-142-... → issue DRAPPS-142), Hilbana:

  • Attaches the PR to the issue (number, link, branch and status).
  • Moves the issue’s state: when the PR is opened or reopened, to a started state; when it’s merged, to a completed state.

How to use it

  1. In Settings → GitHub, click Connect and install the app on GitHub.
  2. Name your branches including the issue’s identifier.
  3. Open and merge PRs as usual: the issue updates itself.

Details

  • The connection is multi-installation: each event resolves to the right workspace.
  • Disconnecting removes the link in Hilbana (it doesn’t uninstall the app on GitHub).
  • The transition only happens if the issue’s team has a state in that category.

Related: Issues · Workflow states.