Move the SUID clarification to the function descriptions

_data/functions.yml

@@ -47,7 +47,10 @@ library-load:
 
 suid:
   label: SUID
-  description: It runs with the SUID bit set and may be exploited to access the file system, escalate or maintain access with elevated privileges working as a SUID backdoor. If it is used to run `sh -p`, omit the `-p` argument on systems like Debian (<= Stretch) that allow the default `sh` shell to run with SUID privileges.
+  description: |
+    It runs with the SUID bit set and may be exploited to access the file system, escalate or maintain access with elevated privileges working as a SUID backdoor. If it is used to run `sh -p`, omit the `-p` argument on systems like Debian (<= Stretch) that allow the default `sh` shell to run with SUID privileges.
+
+    This example creates a local SUID copy of the binary and runs it to maintain elevated privileges. To exploit an existing SUID binary skip the first command and run the program using its original path.
 
 sudo:
   label: Sudo
@@ -59,4 +62,7 @@ capabilities:
 
 limited-suid:
   label: Limited SUID
-  description: It runs with the SUID bit set and may be exploited to access the file system, escalate or maintain access with elevated privileges working as a SUID backdoor. If it is used to run commands it only works on systems like Debian (<= Stretch) that allow the default `sh` shell to run with SUID privileges.
+  description: |
+    It runs with the SUID bit set and may be exploited to access the file system, escalate or maintain access with elevated privileges working as a SUID backdoor. If it is used to run commands it only works on systems like Debian (<= Stretch) that allow the default `sh` shell to run with SUID privileges.
+
+    This example creates a local SUID copy of the binary and runs it to maintain elevated privileges. To exploit an existing SUID binary skip the first command and run the program using its original path.

_layouts/bin.html

@@ -24,8 +24,6 @@ layout: common
 
 {% capture code %}
 {%- if function_id == 'suid' or function_id == 'limited-suid' %}
-# This example creates a local SUID copy of the binary and runs it to maintain elevated privileges.
-# To exploit an existing SUID binary instead, skip the following command and run it using its full path.
 sudo sh -c 'cp $(which {{ bin_name }}) .; chmod +s ./{{ bin_name }}'
 {% endif %}
 {%- if function_id == 'capabilities' %}