GitHub integration allows to import Repositories, Branches and Pull Requests into Fibery. The most interesting case is to import Pull Requests and attach them to real work items, like Features, User Stories or Tasks. Thus you will see Pull Requests statuses right in Fibery.
Import GitHub data
GitHub integration can be enabled inside any App. Navigate to an App and click Integrate Type. Select GitHub and connect to your repository:
Then you will see GitHub Types creation. Just confirm it and start sync:
In case of success, in the left area you will see Table Views with all Repositories, Branches and Pull Requests.
Feel free to create other Views to see, for example, Open Pull Requests. These GitHub Types are similar to all the other Types in Fibery, so you can create custom Views and connect to other Types.
Link Pull Requests to User Stories (or any other Types)
To have this connections, you have to encode User Story Id in your Pull Requests. In our team we include User Story Id into a Pull Requests name, like this:
fibery/us#2189 add support date box filter
The main idea is to extract User Story Id from Pull Request name and link User Story and Pull Request Types via automatic rule. This is a two-steps process.
Step 1. Create User Story Id formula field inside Pull Request.
Open any Pull Request and add a new formula, in our case formula will look like this:
Step 2. Create automatic connection between Pull Request and User Story.
Inside a Pull Request create a new Relation field, set relation to User Story and set automatic rule to match any Pull Request with a User Story by Id:
As a result, you will have the following info:
Inside a User Story you will see a list of Pull Requests