Customize Work Categories
How to customize 'Types of Work' and 'Feature vs Maintenance' charts (for Jira and Linear)
Each organization works differently. Our custom configuration allows you to accurately understand what work has been completed at your organization, based on issue tracking data from integrations like Jira and Linear. We hope this will help keep teams on track and prioritize work.
Work “completed” definition
Work completed = work that has been moved to the Done status, or to a custom status in the Done status category. Use the toggle on the chart to show the sum of issues or total story points.
For example: if you have custom Jira statuses like Testing, In Staging, Ready for Release, and Released, and the last 2 statuses are both in the Done category, then we count number of issues moved either to Ready for Release or Released.
Note: We exclude subtasks from the analyses.
Work completed = work that has been moved to Done. Use the toggle on the chart to show the sum of issues or total story points.
We include both issues and sub-issues in our sums.
How to customize “work” completed
Work can be defined by using Issue Type, Epic, and/or Label (you can not select Subtask or issue types of custom hierarchy levels).
We will only show epics that are currently in an “open”-type status.
If you define a category using an epic that later gets closed, the chart will still show the issues in that closed epic for that category, until you decide to remove this epic from the category definition.
If you remove the closed epic from your configuration, it will disappear from the epics dropdown and you will no longer be able to use it.
Our default for Types of Work is to categorize issues by Issue Type. The Jira defaults for this are Story, Bug, or Task, but you may have your own custom issue types.
Our default for Feature vs Maintenance is to categorize issues by Issue Type, where issues called bug, tech debt, or chore are displayed in various shades of purple, to indicate that it’s all Maintenance work. All other issues are grouped into the green Feature work.
Note that an older release of this chart defaulted to categorizing issues based on whether it contained a string called bug, tech debt, or chore. Now, the config default will look for an exact match (of course, configurable!).
Work can be defined by using Project and/or Label.
Our default for Types of Work is to categorize by Project.
Our default for Feature vs Maintenance is to categorize by Project, where projects called bug, tech debt, or chore are displayed in various shades of purple, to indicate that it’s all Maintenance work. All other projects are grouped into the green Feature work.
You can define categories of work based on combinations of OR and AND conditions. For example, you can define a custom work category, Customer Support, that is defined as where an Epic is Support, and the Label is one of Customer Apple, Customer Grape, Customer Peach.
Configure these categories based on how your teams think about where your time goes. This will help to see at-a-glance where your team’s split of time is what you would expect.
Note that we run our Linear pipeline hourly, so changes you make to issues in Linear will come through in an hour or less.
How "work" is defined in custom configurations
Each chart’s configurations are organization-wide.
For now, we do allow categories to overlap:
If you define a custom work category called
Supportwhich includes work where Label isCustomer, and another custom work categoryCustomerwhich also includes work where Label isCustomer, then work completed with a Label that isCustomerwill be counted in both categories.This helps some companies that prefer to have an accurate relative comparison of work across categories.
In the Feature vs Maintenance chart only, we will flag this discrepancy because it means some issues are being double counted, and it inflates the total issues done for that week or month (to over 100%).
For now, we handle work that falls outside custom categorization differently across the two charts:
In the
Types of Workchart, anything that is not captured by custom categories will go into theUnassignedbucket (which cannot be removed)In the
Feature vs Maintenancechart, you have 2 options. Work that falls outside configured rules can either be:Counted as
Feature work, by selecting the “Everything else” option when editing the Feature category (see image below; this is the default - since a lot of teams are using this chart to get a quick high level view of the two buckets, it’s easier to think of all work that’s not Maintenance as part of the Feature)Not counted at all, by selecting the “Only specific issues” option when editing the Feature category (see image below; this means some work will be completely excluded from the chart if it isn’t captured by the defined conditions)
Last updated
Was this helpful?