diff --git a/lib/puppet/functions/with.rb b/lib/puppet/functions/with.rb
index 1b2b1e0e4..10c0824a8 100644
--- a/lib/puppet/functions/with.rb
+++ b/lib/puppet/functions/with.rb
@@ -1,15 +1,23 @@
 # Call a lambda with the given arguments. Since the parameters of the lambda
 # are local to the lambda's scope, this can be used to create private sections
 # of logic in a class so that the variables are not visible outside of the
 # class.
+#
+# @example Using with
+#
+#     # notices the array [1, 2, 'foo']
+#     with(1, 2, 'foo') |$x, $y, $z| { notice [$x, $y, $z] }
+#
+# @since 3.7.0
+#
 Puppet::Functions.create_function(:with) do
   dispatch :with do
     param 'Object', 'arg'
     arg_count(0, :default)
     required_block_param
   end
 
   def with(*args)
     args[-1].call({}, *args[0..-2])
   end
 end