diff --git a/Library/Homebrew/.yardopts b/Library/Homebrew/.yardopts
index 44655767cf..b90bbe7b21 100644
--- a/Library/Homebrew/.yardopts
+++ b/Library/Homebrew/.yardopts
@@ -5,10 +5,12 @@
 --plugin sorbet
 --load yard/ignore_directives.rb
 --template-path yard/templates
+--exclude sorbet/rbi/gems/
 --exclude test/
 --exclude vendor/
 --exclude yard/
 extend/os/**/*.rb
 **/*.rb
+**/*.rbi
 -
 *.md
diff --git a/Library/Homebrew/extend/hash/deep_transform_values.rb b/Library/Homebrew/extend/hash/deep_transform_values.rb
index 608e3c73a8..2787efc1f6 100644
--- a/Library/Homebrew/extend/hash/deep_transform_values.rb
+++ b/Library/Homebrew/extend/hash/deep_transform_values.rb
@@ -6,6 +6,7 @@ class Hash
   # This includes the values from the root hash and from all
   # nested hashes and arrays.
   #
+  # @example
   #  hash = { person: { name: 'Rob', age: '28' } }
   #
   #  hash.deep_transform_values{ |value| value.to_s.upcase }