diff --git a/src/Commands/DrushCommands.php b/src/Commands/DrushCommands.php
index 8ce8badaa0..2d97b129ff 100644
--- a/src/Commands/DrushCommands.php
+++ b/src/Commands/DrushCommands.php
@@ -73,7 +73,7 @@ protected function io(): DrushStyle
      */
     public function logger(): ?DrushLoggerManager
     {
-        assert(is_null($this->logger) || $this->logger instanceof DrushLoggerManager);
+        assert(is_null($this->logger) || $this->logger instanceof DrushLoggerManager, 'Instead of using replacing Drush\'s logger, use $this->add() on DrushLoggerManager to add a custom logger. See https://github.com/drush-ops/drush/pull/5022');
         return $this->logger;
     }