diff --git a/lib/linguist/blob_helper.rb b/lib/linguist/blob_helper.rb
index 583b2416..47031a49 100644
--- a/lib/linguist/blob_helper.rb
+++ b/lib/linguist/blob_helper.rb
@@ -9,7 +9,8 @@ require 'yaml'
 
 module Linguist
   # DEPRECATED Avoid mixing into Blob classes. Prefer functional interfaces
-  # like `Language.detect` over `Blob#language`.
+  # like `Language.detect` over `Blob#language`. Functions are much easier to
+  # cache and compose.
   #
   # Avoid adding additional bloat to this module.
   #