diff --git a/lib/WebGUI/Workflow/Instance.pm b/lib/WebGUI/Workflow/Instance.pm
index 5c8a795f2..57d99e5b9 100644
--- a/lib/WebGUI/Workflow/Instance.pm
+++ b/lib/WebGUI/Workflow/Instance.pm
@@ -310,6 +310,8 @@ Executes the next iteration in this workflow. Returns a status code based upon w
  complete	The activity completed successfully, you may run the next one.
  waiting	The activity is waiting on an external event such as user input.
 
+B>NOTE:> You should normally never run this method. The workflow engine will use it instead. When you're ready to kick off a workflow you've created, use start() instead.
+
 =cut
 
 sub run {