functions: add puppet-strings docs

Author: kenyon

functions/bytes_to_size.pp

@@ -1,3 +1,10 @@
+# @summary Convert a number of bytes to a size format that LVM can understand
+#
+# @return LVM-formatted size
+#
+# @example Return `200g`
+#
+#   lvm::bytes_to_size(214748364800)
 function lvm::bytes_to_size (
   Numeric $size,
 ) {

functions/size_to_bytes.pp

@@ -1,3 +1,6 @@
+# @summary Convert an LVM size to bytes, the opposite of `lvm::bytes_to_size`
+#
+# @return byte value of LVM-formatted size
 function lvm::size_to_bytes (
   String $size,
 ) {