How to Integrate with GitHub
Qordoba's GitHub integration simplifies workflows for developers. It automatically detects updated strings and streamlines the process of handing off content between teams. Integration increases developer productivity and eliminates errors caused by manual string management.
This guide will show how to gain the required repository access permissions within Github, as well as how to enable the Github Qordoba App during workspace creation.
1. Gain permissions within Github
Make sure that you have admin privileges to the specific repository that you want to connect with Qordoba. You need the organization admin to add you as an admin collaborator at the repository level.
2. Create Workspace Within Qordoba
In Qordoba, create a new workspace, and fill out the preliminary fields. Make sure that you select "Github Apps" for the integration type. Once you get to the Github authentication page, you should see this:
Notice there is a "Authorize your session here" button. Click on it.
3. Use Popup to Give Permissions at Repository Level
When you click the Authorize button, a popup window will appear. In the popup, click Install in the top right, and look for the organization with your desired repository:
In that organization, you should have permission to specifically allow the one repository that you have admin access to:
Once you have selected and saved that repository, you should be able to select that same repository from the dropdown menu back in Qordoba's UI. Afterwards, select your protected branch, as well as the desired naming convention for files that are returning to Github from Qordoba. Complete the workspace creation.
Once the workspace is created, the integration is complete. Qordoba adds a webhook to the Github repository that will look at PRs sent against the protected branch and pull new content into Qordoba.
Need more help? Contact us!
You can reach us at firstname.lastname@example.org