diff --git a/README.md b/README.md
index ac063c6..43a827f 100644
--- a/README.md
+++ b/README.md
@@ -54,5 +54,7 @@ to process the media.
 
 ### transcode
 
+*This plugin is currently broken*
+
 Transcode uses the transcode tool from transcoder.org. While powerful, it
 works best with AVI files.
diff --git a/plugins/executor/README.md b/plugins/executor/README.md
index 5d8efc3..4f0b9e4 100644
--- a/plugins/executor/README.md
+++ b/plugins/executor/README.md
@@ -86,12 +86,14 @@ Helpers are not executed, but rather called:
         ...
             split:
                 info: Splitting video
+                # call the scenesplitter helper
                 call: scenesplitter
             cleanup:
                 exec: "rm {%scenes}"
         helpers:
+            # scenesplitter helper, embedded in preset file
             scenesplitter: |
                 /*
                  * This is the PHP script
                  *
-                ...
+        ...