diff --git a/Library/Homebrew/.rubocop.yml b/Library/Homebrew/.rubocop.yml
index 06f2295cdf..b0c21afab7 100644
--- a/Library/Homebrew/.rubocop.yml
+++ b/Library/Homebrew/.rubocop.yml
@@ -18,6 +18,7 @@ Naming/PredicateName:
     - is_64_bit?
 
 # Only enforce documentation for public APIs.
+# Checked by the tests.yml syntax job
 Style/Documentation:
   AllowedConstants:
     - Homebrew
diff --git a/Library/Homebrew/extend/kernel.rb b/Library/Homebrew/extend/kernel.rb
index a70637fb25..1cf47c04d7 100644
--- a/Library/Homebrew/extend/kernel.rb
+++ b/Library/Homebrew/extend/kernel.rb
@@ -2,6 +2,7 @@
 # frozen_string_literal: true
 
 # Contains shorthand Homebrew utility methods like `ohai`, `opoo`, `odisabled`.
+# TODO: move these out of `Kernel`.
 module Kernel
   extend T::Sig