Recommended Reader(s): Super Admins, Admins
What does it do?
The GitHub integration allows GitHub users to track development work and their activity to automatically drive progress on their objectives in Betterworks.
How does it work?
Using authentication to a user's individual GitHub account, a Betterworks user has access to any of their GitHub organizations or repositories and can use filters to locate specific pull requests or issues to integrate and track progress on in Betterworks.
How is it set up?
As long as an Admin has enabled the GitHub integration from the Third-Party Integrations control panel in the Platform Configuration section of the Admin Panel, this integration will be available to all users in the Create/Edit Key Result/Milestone panel:
Selecting the GitHub Octocat icon opens a window in which a user can customize their integration. The first filter must be used to select either an Organization or a Repository to which the account has access in order to see either Pull Requests or Issues in the results field - a single key result/milestone cannot be integrated with items across different Organizations or Repositories.
Once the first filter has been defined, users are able to set a list of custom filters from which they can manually select issues/requests or enable the "Sync all issues" toggle so that the filters chosen define a dynamic list of requests or issues to track in Betterworks.
As issues are closed and pull requests are either merged or closed, progress will be reflected in Betterworks!
Note: This integration is built to work with the web version of GitHub (github.com) only and users will not be able to connect to an Enterprise edition.