diff --git a/examples/yaml-pipe-tpl.php b/examples/yaml-pipe-tpl.php
index 38ebbe7..a372959 100755
--- a/examples/yaml-pipe-tpl.php
+++ b/examples/yaml-pipe-tpl.php
@@ -1,7 +1,13 @@
 #!/usr/bin/env pogo
 <?php
 
-## This example uses several ?php directives to show that it works with templates.
+## This example is decent smoke-test - it relies on several things
+## - Uses multiple ?php directives
+## - Uses STDIN and $argv
+## - Uses a third-party library
+## - Can be executed/tested with just a little bash scripting
+##
+## Usage: echo '{name: Alice, color: cyan}' | pogo yaml-pipe-tpl.php foo bar
 
 #!require symfony/yaml: ~3.0
 $parsed = Symfony\Component\Yaml\Yaml::parse(file_get_contents(pogo_stdin()));