GitHub: pull requests next to your tasks
How to connect a GitHub repository to a project so pull requests find their tasks and their state shows on the task card.
If your team keeps its code on GitHub, Syncra can show pull requests right on the task card. A pull request is a proposal to change the code that gets reviewed before it is merged into the main branch. You see whether it is open, merged or closed without switching to GitHub.
You connect a repository to a Syncra project, one repository per project.
How to connect a repository
Workspace owners and admins can connect and disconnect a repository. Other members see the field but cannot change it.
- Open the project settings and find the GitHub section.
- In the text field of this section (when empty, it shows
owner/repository), enter the repository name in that form, for exampleacme/site. A full link to the repository is not accepted. - Press Save. The message “GitHub repository saved” appears.
A project has one repository. The same repository cannot be connected to two projects: if you try, Syncra says it is already connected to another one. To disconnect, press Disconnect in the same section. The message “GitHub repository disconnected” appears.
How a pull request finds its task
Every task in Syncra has a short number, such as SYN-298. Syncra looks for the number of a task from the connected project in this order:
- in the pull request title;
- if it is not there, in the branch name;
- if it is not there either, in the description.
Syncra matches only the number. A pull request with a title similar to a task’s title is not linked. So include the task number in branch and pull request names, for example SYN-298 Fix sign-in.
What you see in Syncra
Open the task card. It shows a Pull requests row with the state of each linked pull request:
- Open
- Merged
- Closed
What does not exist
- You can connect a single repository, not a whole GitHub organization.
- Saving the repository name is not enough. Pull requests show up in tasks only once GitHub starts sending Syncra events about them, and Syncra settings have no screen for turning that on. To have GitHub set up to send these events for your repository, write to the Syncra team in Telegram: https://t.me/morzac.
- A merged pull request does not complete the task by itself. Mark the task as completed by hand.
Read next
Updated: