diff --git a/Library/Homebrew/os/linux.rb b/Library/Homebrew/os/linux.rb
index da4b9d7acddc54cbe9faff25ddb32330535eb9ab..1e3cb24fa8968648b06dd9f8ff009ea91a8969eb 100644
--- a/Library/Homebrew/os/linux.rb
+++ b/Library/Homebrew/os/linux.rb
@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module OS
+  # Helper module for querying system information on Linux.
   module Linux
     module_function
 
@@ -21,7 +22,7 @@ module OS
     end
   end
 
-  # Define OS::Mac on Linux for formula API compatibility.
+  # rubocop:disable Style/Documentation
   module Mac
     module_function
 
@@ -77,4 +78,5 @@ module OS
       end
     end
   end
+  # rubocop:enable Style/Documentation
 end
diff --git a/Library/Homebrew/os/mac.rb b/Library/Homebrew/os/mac.rb
index b44a47bcc441e1482cd44262819ceef29ff45e95..8e9d0d33f31f048d1546545d8f45f1f0967f47b2 100644
--- a/Library/Homebrew/os/mac.rb
+++ b/Library/Homebrew/os/mac.rb
@@ -7,6 +7,7 @@ require "os/mac/sdk"
 require "os/mac/keg"
 
 module OS
+  # Helper module for querying system information on macOS.
   module Mac
     module_function