You will be able to configure the GitHub integration by going to a project’s Settings, under the Integrations tab.
One project can be connected to many repositories at the same time.
Finding the Github integration
Integration Options
It’s a two-way sync: you can both create Tasks from your GitHub Issues and create Issues from your Dework Tasks.
Connecting a repo
Import existing Github issues to Dework
If selected when connecting the repo, it will import all existing issues from that repo to Dework. New Dework tasks will be created and things like issue Name, Description and Labels will carry over.
Create Dework Tasks from GitHub Issues
This is enabled by default. New issues created in your GitHub repository will automatically create tasks in the To Do column of your Dework project. Some metadata like issue Name, Description and Labels will carry over.
Create GitHub Issues when Dework task is created
You can decide to enable it right after selecting a repository to connect in your project Settings. When creating a task in your project on Dework, it will automatically create an issue in your GitHub repository.
For bigger GitHub repos, you might not always want to sync all issues to Dework. When adding a repo, you can select which labels should be synced
Note: If your repos are already connected, you will need to disconnect & reconnect to enable this
Select specifically labelled issues to sync from GitHub to Dework
Link tasks with Pull Requests
After connecting a repository to a project, we will automatically generate branch names for your tasks that you can then use to link a specific task to a new branch.
This branch name can be found when clicking the Link GitHub Branch button on your tasks.
Linking a branch to a task
Automation: After linking a task to a branch, if a Pull Request is opened, the task’s status will automatically change to In Review. Then, if the PR is merged, the task will move to Done.
