7min

Linear

Purpose

Echoes can connect to your Linear instance and help you tag Linear issues with the intended outcomes and initiatives they contribute to. This allows you to express the purpose of work during the planning process in Linear and have related code contributions inherit these annotations, therefore reducing the labelling effort for engineers.

Installation

Linear integration is done through the integrations settings.

Echoes integrations
Echoes integrations

You can connect to Linear using either the OAuth flow (recommended), or providing a personal API keys generated through your Linear settings.

Linear installation flow
Linear installation flow

The installation is finalized by selecting the teams you wish to enable Echoes for.

Selecting Linear teams
Selecting Linear teams

How to use

Echoes creates labels on all teams on which it is enabled: one for each configured outcome and initiative (they will all be prefixed with Echoes: ):

Linear issue labels created by Echoes
Linear issue labels created by Echoes

You can link GitHub pull requests or GitLab merge requests to Linear issues through their branch name, the issue ID in their title, or the issue ID in their description (as described on Linear documentation). When Echoes detects a link, it will directly apply the labels it finds on both the linked issue and its parent (if any).

Echoes bot retrieves the label from a linked Linear issuee
Echoes bot retrieves the label from a linked Linear issuee

Labeling behavior details

  • Labels are only applied when a pull request is opened, edited, or reopened. Changing the intent on a Linear ticket will not change the labels on a previously opened pull request.
  • The automation only adds more labels and never removes previously existing labels from the pull request.

๏ปฟ

๏ปฟ

๏ปฟ

๏ปฟ

Updated 20 Jan 2022
Did this page help you?
Yes
No