View all articles

How do pull requests and issues get linked?

DX links GitHub and GitLab pull requests with Jira or Linear issues, when possible. This process works regardless of whether the pull request or issue was imported first.

How it works

  1. When DX imports a pull request, the pull request title and branch name are scanned for Jira and Linear issue IDs.
  2. Pull request descriptions are also scanned for Linear issue IDs. For Jira, description scanning is disabled by default, but can be enabled upon request.
  3. If any IDs are found, they are written to the issue_tracker_key column and DX attempts to find a matching Jira or Linear issue ID in the database.
  4. If a matching issue is found, the linear_issue_id or jira_issue_id column is set with a foreign key.