diff --git a/internal/agent/event/event.go b/internal/agent/event/event.go
index 83dbbcba5..a6448e1ad 100644
--- a/internal/agent/event/event.go
+++ b/internal/agent/event/event.go
@@ -16,7 +16,7 @@ type Event interface {
 	isEventFromThisPackage()
 }
 
-// Recorder records events generated from running a Workflow.
+// Recorder provides event recording methods.
 type Recorder interface {
 	RecordEvent(context.Context, Event)
 }
diff --git a/internal/agent/workflow/handler.go b/internal/agent/workflow/handler.go
index 8310d6ad3..e63f7c8e6 100644
--- a/internal/agent/workflow/handler.go
+++ b/internal/agent/workflow/handler.go
@@ -11,7 +11,5 @@ type Handler interface {
 	// HandleWorkflow begins executing the given workflow. The event recorder can be used to
 	// indicate the progress of a workflow. If the given context becomes cancelled, the workflow
 	// handler should stop workflow execution.
-	//
-	// HandleWorkflow should not return errors for
 	HandleWorkflow(context.Context, Workflow, event.Recorder) error
 }