- newfunction(:delete_at, :type => :rvalue, :doc => <<-EOS
-Deletes a determined indexed value from an array.
+ newfunction(:delete_at, :type => :rvalue, :doc => <<-DOC) do |arguments|
+ @summary
+ Deletes a determined indexed value from an array.
+
+ For example
+ ```delete_at(['a','b','c'], 1)```
+
+ Would return: `['a','c']`
+
+ > *Note:*
+ Since Puppet 4 this can be done in general with the built-in
+ [`filter`](https://puppet.com/docs/puppet/latest/function.html#filter) function:
+
+ ```['a', 'b', 'c'].filter |$pos, $val | { $pos != 1 }```