Hooks

- Updated documentation and style of example hook scripts.

scripts/hooks/on-launch

@@ -1,21 +1,18 @@
 #!/bin/bash
 
-# The on-launch event is triggered once, after initialization, before an
-# processing occurs
+# The on-launch event is triggered once, after initialization, before any
+# processing occurs, i.e first
 
-# No input
-
-# Processing goes here
+# Input:
+# - none
 
 # Output:
-# - all emitted JSON lines must be fully-formed tasks
-# - all emitted non-JSON lines are considered feedback messages
-echo on-launch
+# - all emitted JSON lines are added/modified as tasks, if the exit code is
+#   zero, otherwise ignored.
+# - minimal new task:  {"description":"Buy milk"}
+# - to modify a task include complete JSON
+# - all emitted non-JSON lines are considered feedback messages if the exit
+#   code is zero, otherwise they are considerederrors.
 
-# Exit:
-#   0 Means:     - all emitted JSON lines are added/modified
-#                - all emitted non-JSON lines become footnote entries
-#   non-0 Means: - all emitted JSON lines are ignored
-#                - all emitted non-JSON lines become error entries
+echo 'on-launch'
 exit 0
-