Add a link to help you read the backtrace

CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ### UNRELEASED
 
+### 7.8.0
+
+* Add a link to help you read the backtrace.
+
+    https://github.com/KnapsackPro/knapsack_pro-ruby/pull/267
+
+https://github.com/KnapsackPro/knapsack_pro-ruby/compare/v7.7.0...v7.8.0
+
 ### 7.7.0
 
 * Log threads when the OS signal is received to simplify debugging, especially when a CI node hangs.

lib/knapsack_pro/runners/queue/base_runner.rb

@@ -71,6 +71,7 @@ def log_threads
           puts '=' * 80
           puts "Start logging #{threads.count} detected threads."
           puts 'Use the following backtrace(s) to find the line of code that got stuck if the CI node hung and terminated your tests.'
+          puts 'How to read the backtrace: https://knapsackpro.com/perma/ruby/backtrace-debugging'
 
           threads.each do |thread|
             puts

spec/integration/runners/queue/rspec_runner_spec.rb

@@ -1322,6 +1322,8 @@ def when_first_matching_example_defined(type:)
             Thread.new do
               sleep 10
             end
+
+            sleep 1 # wait for the above async thread to start
           end
         end
       SPEC