Refer to the FAQ if a log message has an entry

Author: kraih

Changes

@@ -1,5 +1,6 @@
 
-9.33  2023-05-10
+9.33  2023-05-15
+  - Improved log messages to refer to the FAQ when they have an entry.
 
 9.32  2023-05-09
   - Improved file and line number details in async/await exceptions. (batman)

lib/Mojo/Server/Daemon.pm

@@ -200,7 +200,7 @@ sub _listen {
       $stream->on(close   => sub { $self && $self->_close($id) });
       $stream->on(error   => sub { $self && $self->app->log->error(pop) && $self->_close($id) });
       $stream->on(read    => sub { $self->_read($id => pop) });
-      $stream->on(timeout => sub { $self->_trace($id, 'Inactivity timeout') });
+      $stream->on(timeout => sub { $self->_trace($id, 'Inactivity timeout (see FAQ for more)') });
     }
   );
 

lib/Mojo/Server/Prefork.pm

@@ -110,7 +110,7 @@ sub _manage {
     next unless my $w = $self->{pool}{$pid};
 
     # No heartbeat (graceful stop)
-    $log->error("Worker $pid has no heartbeat ($ht seconds), restarting") and $w->{graceful} = $time
+    $log->error("Worker $pid has no heartbeat ($ht seconds), restarting (see FAQ for more)") and $w->{graceful} = $time
       if !$w->{graceful} && ($w->{time} + $interval + $ht <= $time);
 
     # Graceful stop with timeout

lib/Mojolicious.pm

@@ -45,7 +45,7 @@ has secrets            => sub {
   my $self = shift;
 
   # Warn developers about insecure default
-  $self->log->trace('Your secret passphrase needs to be changed');
+  $self->log->trace('Your secret passphrase needs to be changed (see FAQ for more)');
 
   # Default to moniker
   return [$self->moniker];
@@ -141,7 +141,8 @@ sub handler {
   $self->plugins->emit_chain(around_dispatch => $c);
 
   # Delayed response
-  $c->helpers->log->trace('Nothing has been rendered, expecting delayed response') unless $c->stash->{'mojo.rendered'};
+  $c->helpers->log->trace('Nothing has been rendered, expecting delayed response (see FAQ for more)')
+    unless $c->stash->{'mojo.rendered'};
 }
 
 sub helper { shift->renderer->add_helper(@_) }