diff --git a/_gtfobins/puppet.md b/_gtfobins/puppet.md
index f1f9d75..e8f553f 100644
--- a/_gtfobins/puppet.md
+++ b/_gtfobins/puppet.md
@@ -1,19 +1,23 @@
 ---
 functions:
   execute-non-interactive:
-    - code: |
+    - description: The executed command output is not shown and can be redirected to a file.
+      code: |
         export CMD="/usr/bin/id"
         puppet apply -e "exec { '${CMD}': }"
   sudo-enabled:
-    - code: |
+    - description: The executed command output is not shown and can be redirected to a file.
+      code: |
         export CMD="/usr/bin/id"
         sudo puppet apply -e "exec { '${CMD}': }"
   file-read:
-    - code: |
+    - description: The read file content is corrupted by the `diff` output format.
+      code: |
         export LFILE=file_to_read
         puppet filebucket -l diff /dev/null ${LFILE}
   file-write:
-    - code: |
+    - description: The file path must be absolute.
+      code: |
         export LFILE="/tmp/file_to_write"
         puppet apply -e "file { '${LFILE}': content => 'data' }"
 ---