jirametrics 2.0.1 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 26b8d8955807f88acf9f1cce8443d183a9fb72fce98424aba3c7c29e876a6a38
-  data.tar.gz: '039eb9fd005ed0a036f20c72e8f9a8c4cb4bad19f030ed3cf0445bdb6afb0902'
+  metadata.gz: 0f5551ca8d38a0b12579429080055e21bb161066e7bb2237ada5d47628a212de
+  data.tar.gz: 7bd667226812044854dde31dfac4f347380b077369ec711bec5d6cb98a0082e8
 SHA512:
-  metadata.gz: ecf2036e99a4bed4275da79e58740bac58c00d8a61120872abb0d51459631d7b7f5c80898bf4bb1212a87042c54cdb83ace95c1f86d2f2df43b8611626bbf1a0
-  data.tar.gz: 5f01cabf487497389977fab8d341d5173e3c5835c8e42422d232aa3ba5b8aaa40af0cb975235374bf953cecf45b2615c5f6b6391560fcdcf6c0f1d77d6ae9e3f
+  metadata.gz: 397a3c4eb84497df209c702858a77def1d9606eecf84d08a8ab7b4f0a6decd968f77ed617f8189acb4916e372742bfc8352bb0fcd2b5ad74e04880c03680fece
+  data.tar.gz: 8aa2cbc8d7e60ed80749bf58c48d78689adcb65892ad133a378956b308fdb3d326a665eb3a884bd9d29783142639813f696c77f393697e285a0b7769fbe0ad18

data/lib/jirametrics/aggregate_config.rb

@@ -3,7 +3,7 @@
 require 'date'
 
 class AggregateConfig
-  attr_reader :project_config
+  attr_reader :project_config, :included_projects
 
   def initialize project_config:, block:
     @project_config = project_config

data/lib/jirametrics/aging_work_bar_chart.rb

@@ -17,15 +17,17 @@ class AgingWorkBarChart < ChartBase
       <p>
         There are potentially three bars for each issue, although a bar may be missing if the issue has no
         information relevant to that. Hovering over any of the bars will provide more details.
-        <ol><li>The top bar tells you what status the issue is in at any time.</li>
-        <li>The middle bar indicates blocked and stalled states. A lighter orange is stalled and a darker,
-        reddish colour is blocked.</li>
-        <li>The bottom bar indicated an expedited state.</li></ol>
-      </p>
-      <p>
-        The gray backgrounds indicate weekends and the red vertical line indicates the 85% point for all
-        items in this time period. Anything that started to the left of that is now an outlier.
+        <ol>
+          <li>The top bar tells you what status the issue is in at any time. The colour indicates the
+          status category, which will be one of #{color_block '--status-category-todo-color'} To Do,
+          #{color_block '--status-category-inprogress-color'} In Progress,
+          or #{color_block '--status-category-done-color'} Done</li>
+          <li>The middle bar indicates #{color_block '--blocked-color'} blocked
+          or #{color_block '--stalled-color'} stalled.</li>
+          <li>The bottom bar indicated #{color_block '--expedited-color'} expedited.</li>
+        </ol>
       </p>
+      #{ describe_non_working_days }
     HTML
 
     # Because this one will size itself as needed, we start with a smaller default size
@@ -65,7 +67,7 @@ class AgingWorkBarChart < ChartBase
           issue_label: issue_label,
           title_label: 'Expedited',
           stack: 'expedited',
-          color: 'red',
+          color: CssVariable['--expedited-color'],
           start_date: issue_start_date
         ) { |day| issue.expedited_on_date?(day) }
       ].compact.flatten.each do |data|
@@ -109,7 +111,7 @@ class AgingWorkBarChart < ChartBase
             title: "#{issue.type} : #{change.value}"
           }],
           backgroundColor: status_category_color(status),
-          borderColor: 'white',
+          borderColor: CssVariable['--aging-work-bar-chart-separator-color'],
           borderWidth: {
              top: 0,
              right: 1,
@@ -144,10 +146,13 @@ class AgingWorkBarChart < ChartBase
   end
 
   def one_block_change_data_set starting_change:, ending_time:, issue_label:, stack:, issue_start_time:
-    color = settings['colors']['blocked']
-    color = settings['colors']['stalled'] if starting_change.stalled?
+    deprecated message: 'blocked color should be set via css now', date: '2024-05-03' if settings['blocked_color']
+    deprecated message: 'blocked color should be set via css now', date: '2024-05-03' if settings['stalled_color']
+
+    color = settings['blocked_color'] || '--blocked-color'
+    color = settings['stalled_color'] || '--stalled-color' if starting_change.stalled?
     {
-      backgroundColor: color,
+      backgroundColor: CssVariable[color],
       data: [
         {
           title: starting_change.reasons,

data/lib/jirametrics/aging_work_in_progress_chart.rb

@@ -14,13 +14,14 @@ class AgingWorkInProgressChart < ChartBase
     description_text <<-HTML
       <p>
         This chart shows only work items that have started but not completed, grouped by the column
-      they're currently in. Hovering over a dot will show you the ID of that work item.
-      </p>
-      <p>
-        The gray area indicates the 85% mark for work items that have passed through here - 85% of
-        previous work items left this column while still inside the gray area. Any work items above
-        the gray area are outliers and they are the items that you should pay special attention to.
+        they're currently in. Hovering over a dot will show you the ID of that work item.
       </p>
+      <div>
+        The #{color_block '--non-working-days-color'} shaded area indicates the 85%
+        mark for work items that have passed through here; 85% of
+        previous work items left this column while still inside the shaded area. Any work items above
+        the shading are outliers and they are the items that you should pay special attention to.
+      </div>
     HTML
     init_configuration_block(block) do
       grouping_rules do |issue, rule|
@@ -87,6 +88,7 @@ class AgingWorkInProgressChart < ChartBase
       'label' => "#{percentage}%",
       'barPercentage' => 1.0,
       'categoryPercentage' => 1.0,
+      'backgroundColor' => CssVariable['--aging-work-in-progress-chart-shading-color'],
       'data' => days_at_percentage_threshold_for_all_columns(percentage: percentage, issues: @issues).drop(1)
     }
   end

data/lib/jirametrics/aging_work_table.rb

@@ -7,14 +7,22 @@ class AgingWorkTable < ChartBase
 
   def initialize block
     super()
-    @blocked_icon = '🛑'
-    @expedited_icon = '🔥'
-    @stalled_icon = '🟧'
     @stalled_threshold = 5
-    @dead_icon = '⬛'
     @dead_threshold = 45
     @age_cutoff = 0
 
+    header_text 'Aging Work Table'
+    description_text <<-TEXT
+      <p>
+        This chart shows all active (started but not completed) work, ordered from oldest at the top to
+        newest at the bottom.
+      </p>
+      <p>
+        If there are expedited items that haven't yet started then they're at the bottom of the table.
+        By the very definition of expedited, if we haven't started them already, we'd better get on that.
+      </p>
+    TEXT
+
     instance_eval(&block) if block
   end
 
@@ -28,7 +36,7 @@ class AgingWorkTable < ChartBase
     end
     aging_issues += expedited_but_not_started.sort_by(&:created)
 
-    render(binding, __FILE__)
+    wrap_and_render(binding, __FILE__)
   end
 
   def select_aging_issues
@@ -54,7 +62,7 @@ class AgingWorkTable < ChartBase
     return unless issue.expedited?
 
     name = issue.raw['fields']['priority']['name']
-    icon_span(title: "Expedited: Has a priority of &quot;#{name}&quot;", icon: @expedited_icon)
+    color_block '--expedited-color', title: "Expedited: Has a priority of &quot;#{name}&quot;"
   end
 
   def blocked_text issue
@@ -63,27 +71,24 @@ class AgingWorkTable < ChartBase
 
     current = issue.blocked_stalled_changes(end_time: time_range.end)[-1]
     if current.blocked?
-      icon_span title: current.reasons, icon: @blocked_icon
+      color_block '--blocked-color', title: current.reasons
     elsif current.stalled?
       if current.stalled_days && current.stalled_days > @dead_threshold
-        icon_span(
+        color_block(
+          '--dead-color',
           title: "Dead? Hasn&apos;t had any activity in #{label_days current.stalled_days}. " \
-            'Does anyone still care about this?',
-          icon: @dead_icon
+            'Does anyone still care about this?'
         )
       else
-        icon_span(
-          title: current.reasons,
-          icon: @stalled_icon
-        )
+        color_block '--stalled-color', title: current.reasons
       end
     end
   end
 
   def unmapped_status_text issue
     icon_span(
-      title: "The status #{issue.status.name.inspect} is not mapped to any column and will not be visible",
-      icon: ' ⁉️'
+      title: "Not visible: The status #{issue.status.name.inspect} is not mapped to any column and will not be visible",
+      icon: ' 👀'
     )
   end
 

data/lib/jirametrics/anonymizer.rb

@@ -12,6 +12,7 @@ class Anonymizer
     @all_boards = @project_config.all_boards
     @possible_statuses = @project_config.possible_statuses
     @date_adjustment = date_adjustment
+    @file_system = project_config.exporter.file_system
   end
 
   def run
@@ -20,7 +21,7 @@ class Anonymizer
     # anonymize_issue_statuses
     anonymize_board_names
     shift_all_dates unless @date_adjustment.zero?
-    puts 'Anonymize done'
+    @file_system.log 'Anonymize done'
   end
 
   def random_phrase
@@ -30,7 +31,7 @@ class Anonymizer
     5.times do |i|
       return RandomWord.phrases.next.tr('_', ' ')
     rescue # rubocop:disable Style/RescueStandardError We don't care what exception was thrown.
-      puts "Random word blew up on attempt #{i + 1}"
+      @file_system.log "Random word blew up on attempt #{i + 1}"
     end
   end
 
@@ -55,7 +56,7 @@ class Anonymizer
 
   def anonymize_column_names
     @all_boards.each_key do |board_id|
-      puts "Anonymizing column names for board #{board_id}"
+      @file_system.log "Anonymizing column names for board #{board_id}"
 
       column_name = 'Column-A'
       @all_boards[board_id].visible_columns.each do |column|
@@ -93,7 +94,7 @@ class Anonymizer
   end
 
   def anonymize_issue_statuses
-    puts 'Anonymizing issue statuses and status categories'
+    @file_system.log 'Anonymizing issue statuses and status categories'
     status_name_hash = build_status_name_hash
 
     @issues.each do |issue|
@@ -130,7 +131,7 @@ class Anonymizer
   end
 
   def shift_all_dates
-    puts "Shifting all dates by #{@date_adjustment} days"
+    @file_system.log "Shifting all dates by #{@date_adjustment} days"
     @issues.each do |issue|
       issue.changes.each do |change|
         change.time = change.time + @date_adjustment

data/lib/jirametrics/chart_base.rb

@@ -10,17 +10,11 @@ class ChartBase
 
   def initialize
     @chart_colors = {
-      'dark:Story' => 'green',
-      'dark:Task' => 'blue',
-      'dark:Bug' => 'orange',
-      'dark:Defect' => 'orange',
-      'dark:Spike' => '#9400D3', # dark purple
-      'light:Story' => '#90EE90',
-      'light:Task' => '#87CEFA',
-      'light:Bug' => '#ffdab9',
-      'light:Defect' => 'orange',
-      'light:Epic' => '#fafad2',
-      'light:Spike' => '#DDA0DD' # light purple
+      'Story'  => CssVariable['--type-story-color'],
+      'Task'   => CssVariable['--type-task-color'],
+      'Bug'    => CssVariable['--type-bug-color'],
+      'Defect' => CssVariable['--type-bug-color'],
+      'Spike'  => CssVariable['--type-spike-color']
     }
     @canvas_width = 800
     @canvas_height = 200
@@ -44,11 +38,16 @@ class ChartBase
     erb.result(caller_binding)
   end
 
-  # Render the file and then wrap it with standard headers and quality checks.
-  def wrap_and_render caller_binding, file
+  def render_top_text caller_binding
     result = +''
     result << "<h1>#{@header_text}</h1>" if @header_text
     result << ERB.new(@description_text).result(caller_binding) if @description_text
+  end
+
+  # Render the file and then wrap it with standard headers and quality checks.
+  def wrap_and_render caller_binding, file
+    result = +''
+    result << render_top_text(caller_binding)
     result << render(caller_binding, file)
     result
   end
@@ -57,8 +56,8 @@ class ChartBase
     @@chart_counter += 1
   end
 
-  def color_for type:, shade: :dark
-    @chart_colors["#{shade}:#{type}"] ||= random_color
+  def color_for type:
+    @chart_colors[type] ||= random_color
   end
 
   def label_days days
@@ -199,15 +198,15 @@ class ChartBase
     color = status_category_color status
 
     text = is_category ? status.category_name : status.name
-    "<span style='color: #{color}'>#{text}</span>"
+    "<span title='Category: #{status.category_name}'>#{color_block color.name} #{text}</span>"
   end
 
   def status_category_color status
     case status.category_name
     when nil then 'black'
-    when 'To Do' then 'gray'
-    when 'In Progress' then 'blue'
-    when 'Done' then 'green'
+    when 'To Do' then CssVariable['--status-category-todo-color']
+    when 'In Progress' then CssVariable['--status-category-inprogress-color']
+    when 'Done' then CssVariable['--status-category-done-color']
     end
   end
 
@@ -236,4 +235,21 @@ class ChartBase
     @issues = issues.filter_map { |i| @filter_issues_block.call(i) }.uniq
     puts @issues.collect(&:key).join(', ')
   end
+
+  def color_block color, title: nil
+    result = +''
+    result << "<div class='color_block' style='background: var(#{color});'"
+    result << " title=#{title.inspect}" if title
+    result << '></div>'
+    result
+  end
+
+  def describe_non_working_days
+    <<-TEXT
+      <div class='p'>
+        The #{color_block '--non-working-days-color'} vertical bars indicate non-working days; weekends
+        and any other holidays mentioned in the configuration.
+      </div>
+    TEXT
+  end  
 end

data/lib/jirametrics/css_variable.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+class CssVariable
+  attr_reader :name
+
+  def self.[](name)
+    if name.start_with? '--'
+      CssVariable.new name
+    else
+      name
+    end
+  end
+
+  def initialize name
+    @name = name
+  end
+
+  def to_json(*_args)
+    "getComputedStyle(document.body).getPropertyValue('#{@name}')"
+  end
+
+  def to_s
+    "var(#{@name})"
+  end
+
+  def inspect
+    "CssVariable['#{@name}']"
+  end
+
+  def == other
+    self.class == other.class && @name == other.name
+  end
+end

data/lib/jirametrics/cycletime_scatterplot.rb

@@ -12,20 +12,19 @@ class CycletimeScatterplot < ChartBase
 
     header_text 'Cycletime Scatterplot'
     description_text <<-HTML
-      <p>
+      <div class="p">
         This chart shows only completed work and indicates both what day it completed as well as
         how many days it took to get done. Hovering over a dot will show you the ID of the work item.
-      </p>
-      <p>
-        The gray line indicates the 85th percentile (<%= overall_percent_line %> days). 85% of all
+      </div>
+      <div class="p">
+        The #{color_block '--cycletime-scatterplot-overall-trendline-color'} line indicates the 85th
+        percentile (<%= overall_percent_line %> days). 85% of all
         items on this chart fall on or below the line and the remaining 15% are above the line. 85%
         is a reasonable proxy for "most" so that we can say that based on this data set, we can
         predict that most work of this type will complete in <%= overall_percent_line %> days or
         less. The other lines reflect the 85% line for that respective type of work.
-      </p>
-      <p>
-        The gray vertical bars indicate weekends, when theoretically we aren't working.
-      </p>
+      </div>
+      #{ describe_non_working_days }
     HTML
 
     init_configuration_block block do
@@ -44,7 +43,7 @@ class CycletimeScatterplot < ChartBase
 
     data_sets = create_datasets completed_issues
     overall_percent_line = calculate_percent_line(completed_issues)
-    @percentage_lines << [overall_percent_line, 'gray']
+    @percentage_lines << [overall_percent_line, CssVariable['--cycletime-scatterplot-overall-trendline-color']]
 
     return "<h1>#{@header_text}</h1>No data matched the selected criteria. Nothing to show." if data_sets.empty?
 

data/lib/jirametrics/daily_wip_by_age_chart.rb

@@ -3,23 +3,48 @@
 require 'jirametrics/daily_wip_chart'
 
 class DailyWipByAgeChart < DailyWipChart
+  def initialize block = nil
+    super(block)
+
+    add_trend_line line_color: '--aging-work-in-progress-by-age-trend-line-color', group_labels: [
+      'Less than a day',
+      'A week or less',
+      'Two weeks or less',
+      'Four weeks or less',
+      'More than four weeks'
+    ]
+  end
+
   def default_header_text
     'Daily WIP grouped by Age'
   end
 
   def default_description_text
     <<-HTML
-      <p>
+      <div class="p">
         This chart shows the highest WIP on each given day. The WIP is color coded so you can see
         how old it is and hovering over the bar will show you exactly which work items it relates
-        to. The green bar underneath, shows how many items completed on that day.
-      </p>
-      <p>
-        "Completed without being started" reflects the fact that while we know that it completed
-        that day, we were unable to determine when it had started. These items will show up in
-        white at the top. Note that the white is approximate because we don't know exactly when
-        it started so we're guessing.
-      </p>
+        to. The #{color_block '--wip-chart-completed-color'}
+        #{color_block '--wip-chart-completed-but-not-started-color'}
+        bars underneath, show how many items completed on that day.
+      </div>
+      <% if @has_completed_but_not_started %>
+      <div class="p">
+        #{color_block '--wip-chart-completed-but-not-started-color'} "Completed but not started"
+        reflects the fact that while we know that it completed that day, we were unable to determine when
+        it had started; it had moved directly from a To Do status to a Done status.
+        The #{color_block '--body-background'} shading at the top shows when they might
+        have been active. Note that the this grouping is approximate as we just don't know for sure.
+      </div>
+      <% end %>
+      #{describe_non_working_days}
+      <div class="p">
+        The #{color_block '--aging-work-in-progress-by-age-trend-line-color'} dashed line is a general trend line.
+        <% if @has_completed_but_not_started %>
+        Note that this trend line only includes items where we know both the start and end times of
+        the work so it may not be as accurate as we hope.
+        <% end %>
+      </div>
     HTML
   end
 
@@ -31,6 +56,7 @@ class DailyWipByAgeChart < DailyWipChart
     rules.issue_hint = "(age: #{label_days (rules.current_date - started + 1).to_i})" if started
 
     if stopped && started.nil? # We can't tell when it started
+      @has_completed_but_not_started = true
       not_started stopped: stopped, rules: rules, created: issue.created.to_date
     elsif stopped == rules.current_date
       stopped_today rules: rules
@@ -42,11 +68,11 @@ class DailyWipByAgeChart < DailyWipChart
   def not_started stopped:, rules:, created:
     if stopped == rules.current_date
       rules.label = 'Completed but not started'
-      rules.color = '#66FF66'
+      rules.color = '--wip-chart-completed-but-not-started-color'
       rules.group_priority = -1
     else
       rules.label = 'Start date unknown'
-      rules.color = 'white'
+      rules.color = '--body-background'
       rules.group_priority = 11
       created_days = rules.current_date - created + 1
       rules.issue_hint = "(created: #{label_days created_days.to_i} earlier, stopped on #{stopped})"
@@ -55,7 +81,7 @@ class DailyWipByAgeChart < DailyWipChart
 
   def stopped_today rules:
     rules.label = 'Completed'
-    rules.color = '#009900'
+    rules.color = '--wip-chart-completed-color'
     rules.group_priority = -2
   end
 
@@ -65,23 +91,23 @@ class DailyWipByAgeChart < DailyWipChart
     case age
     when 1
       rules.label = 'Less than a day'
-      rules.color = '#aaaaaa'
+      rules.color = '--wip-chart-duration-less-than-day-color'
       rules.group_priority = 10 # Highest is top
     when 2..7
       rules.label = 'A week or less'
-      rules.color = '#80bfff'
+      rules.color = '--wip-chart-duration-week-or-less-color'
       rules.group_priority = 9
     when 8..14
       rules.label = 'Two weeks or less'
-      rules.color = '#ffd700'
+      rules.color = '--wip-chart-duration-two-weeks-or-less-color'
       rules.group_priority = 8
     when 15..28
       rules.label = 'Four weeks or less'
-      rules.color = '#ce6300'
+      rules.color = '--wip-chart-duration-four-weeks-or-less-color'
       rules.group_priority = 7
     else
       rules.label = 'More than four weeks'
-      rules.color = '#990000'
+      rules.color = '--wip-chart-duration-more-than-four-weeks-color'
       rules.group_priority = 6
     end
   end

data/lib/jirametrics/daily_wip_by_blocked_stalled_chart.rb

@@ -9,18 +9,32 @@ class DailyWipByBlockedStalledChart < DailyWipChart
 
   def default_description_text
     <<-HTML
-      <p>
-        This chart highlights work that is blocked or stalled on each given day. In Jira terms, blocked
-        means that the issue has been "flagged". Stalled indicates that the item hasn't had any updates in 5 days.
-      </p>
-      <p>
-        Note that if an item tracks as both blocked and stalled, it will only show up in the flagged totals.
+      <div class="p">
+        This chart highlights work that is #{color_block '--blocked-color'} blocked,
+        #{color_block '--stalled-color'} stalled, or
+        #{color_block '--wip-chart-active-color'} active on each given day.
+        <ul>
+          <li>#{color_block '--blocked-color'} Blocked could mean that the item has been flagged or it's
+            in a status that is configured as blocked, or it could have a link showing that it is blocked
+          by another item. It all depends how the report has been configured.</li>
+          <li>#{color_block '--stalled-color'} Stalled indicates that there has been no activity on this
+          item in five days.</li>
+        </ul>
+      </div>
+      <div class="p">
+        Note that if an item tracks as both blocked and stalled, it will only show up in the blocked totals.
         It will not be double counted.
-      </p>
-      <p>
-        The white section reflects items that have stopped but for which we can't identify the start date. As
-        a result, we are unable to properly show the WIP for these items.
-      </p>
+      </div>
+      <% if @has_completed_but_not_started %>
+      <div class="p">
+        #{color_block '--wip-chart-completed-but-not-started-color'} "Completed but not started"
+        reflects the fact that while we know that it completed that day, we were unable to determine when
+        it had started; it had moved directly from a To Do status to a Done status.
+        The #{color_block '--body-background'} shading at the top shows when they might
+        have been active. Note that the this grouping is approximate as we just don't know for sure.
+      </div>
+      <% end %>
+      #{describe_non_working_days}
     HTML
   end
 
@@ -47,30 +61,31 @@ class DailyWipByBlockedStalledChart < DailyWipChart
     stopped_today = stopped_date == rules.current_date
 
     if stopped_today && started.nil?
+      @has_completed_but_not_started = true
       rules.label = 'Completed but not started'
-      rules.color = '#66FF66'
+      rules.color = '--wip-chart-completed-but-not-started-color'
       rules.group_priority = -1
     elsif stopped_today
       rules.label = 'Completed'
-      rules.color = '#009900'
+      rules.color = '--wip-chart-completed-color'
       rules.group_priority = -2
     elsif started.nil?
       rules.label = 'Start date unknown'
-      rules.color = 'white'
+      rules.color = '--body-background'
       rules.group_priority = 4
     elsif change&.blocked?
       rules.label = 'Blocked'
-      rules.color = 'red'
+      rules.color = '--blocked-color'
       rules.group_priority = 1
       rules.issue_hint = "(#{change.reasons})"
     elsif change&.stalled?
       rules.label = 'Stalled'
-      rules.color = 'orange'
+      rules.color = '--stalled-color'
       rules.group_priority = 2
       rules.issue_hint = "(#{change.reasons})"
     else
       rules.label = 'Active'
-      rules.color = 'lightgray'
+      rules.color = '--wip-chart-active-color'
       rules.group_priority = 3
     end
   end

data/lib/jirametrics/daily_wip_by_parent_chart.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'jirametrics/daily_wip_chart'
+
+class DailyWipByParentChart < DailyWipChart
+  def initialize block
+    super(block)
+  end
+
+  def default_header_text
+    'Daily WIP, grouped by the parent ticket (Epic, Feature, etc)'
+  end
+
+  def default_description_text
+    <<-HTML
+      <div class="p">
+        How much work is in progress, grouped by the parent of the issue. This will give us an
+        indication of how focused we are on higher level objectives. If there are many parent
+        tickets in progress at the same time, either this team has their focus scattered or we
+        aren't doing a good job of
+        <a href="https://improvingflow.com/2024/02/21/slicing-epics.html">splitting those parent
+        tickets</a>. Neither of those is desirable.
+      </div>
+      <div class="p">
+        The #{color_block '--body-background'} shading at the top shows items that don't have a parent
+        at all.
+      </div>
+      #{describe_non_working_days}
+    HTML
+  end
+
+  def default_grouping_rules issue:, rules:
+    parent = issue.parent&.key
+    if parent
+      rules.label = parent
+    else
+      rules.label = 'No parent'
+      rules.group_priority = 1000
+      rules.color = '--body-background'
+    end
+  end
+end