website logo
Sign upLogin
⌘K
πŸ€—Welcome
πŸš€Engineering success
🧭Alignment
⚑Delivery
πŸ’—Health
🏷️Categorizing work
Dimensions
Initiatives
Teams
🎯Measuring success
Defining targets
Delivery performance
πŸ”ŒData connections
Data sources
Data exports
API authentication
πŸ””Automated reports
Email report
Slack reports
πŸŽ“Reference
πŸ‘€Administration
πŸ“…Changelog
2023
2022
Docs powered byΒ archbeeΒ 
4min

Shortcut

Purpose

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

Installation

Shortcut integration is done through the integrations settings. The installation will guide you into generating a Shortcut API token and installing the webhooks.

Shortcut instalation flow
Shortcut instalation flow
ο»Ώ

How to use

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

You can link GitHub pull requests or GitLab merge requests to Shortcut Stories through their branch name, the issue ID in their title, or the issue ID in their description (as described in Shortcut documentation). Echoes detects this link and directly applies the labels it finds on both the linked Story and its parent Epic (if any).

Labeling behavior details

  • Labels are only applied when a pull request is opened, edited, or reopened. Changing the intent on a Shortcut Story or Epic 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 03 Mar 2023
Did this page help you?
Yes
No
UP NEXT
Incident management
Docs powered byΒ archbeeΒ 
TABLE OF CONTENTS
Purpose
Installation
How to use
Labeling behavior details