style(docs): clarify the Execute function comments across controllers

Signed-off-by: Christian Stewart <christian@aperture.us>

bus/bridge/bridge.go

@@ -52,7 +52,7 @@ func (b *BusBridge) GetControllerInfo() *controller.Info {
 	return controller.NewInfo(ControllerID, Version, "forwards directives to bus")
 }
 
-// Execute executes the given controller.
+// Execute executes the controller goroutine.
 // Returning nil ends execution.
 // Returning an error triggers a retry with backoff.
 func (b *BusBridge) Execute(ctx context.Context) error {

bus/controller.go

@@ -84,7 +84,7 @@ func (c *BusController[T]) GetControllerInfo() *controller.Info {
 	return controller.NewInfo(c.controllerID, c.controllerVersion, c.controllerDescrip)
 }
 
-// Execute executes the given controller.
+// Execute executes the controller goroutine.
 func (c *BusController[T]) Execute(ctx context.Context) error {
 	return nil
 }

controller/callback/callback.go

@@ -53,7 +53,7 @@ func (c *CallbackController) HandleDirective(ctx context.Context, di directive.I
 	return nil, nil
 }
 
-// Execute executes the given controller.
+// Execute executes the controller goroutine.
 // Returning nil ends execution.
 // Returning an error triggers a retry with backoff.
 func (c *CallbackController) Execute(ctx context.Context) error {

controller/configset/controller/controller.go

@@ -46,7 +46,7 @@ func NewController(le *logrus.Entry, bus bus.Bus) (*Controller, error) {
 	}, nil
 }
 
-// Execute executes the given controller.
+// Execute executes the controller goroutine.
 // Returning nil ends execution.
 // Returning an error triggers a retry with backoff.
 func (c *Controller) Execute(ctx context.Context) error {

controller/resolver/controller.go

@@ -67,7 +67,7 @@ func (c *Controller) HandleDirective(ctx context.Context, di directive.Instance)
 	return nil, nil
 }
 
-// Execute executes the given controller.
+// Execute executes the controller goroutine.
 // Returning nil ends execution.
 // Returning an error triggers a retry with backoff.
 func (c *Controller) Execute(ctx context.Context) error {

example/boilerplate/controller/controller.go

@@ -73,7 +73,7 @@ func (c *Controller) HandleDirective(
 	return nil, nil
 }
 
-// Execute executes the given controller.
+// Execute executes the controller goroutine.
 // Returning nil ends execution.
 // Returning an error triggers a retry with backoff.
 func (c *Controller) Execute(ctx context.Context) error {

example/hello-world/controller.go

@@ -46,7 +46,7 @@ func (c *ToyController) HandleDirective(
 	return nil, nil
 }
 
-// Execute executes the given controller.
+// Execute executes the controller goroutine.
 // Returning nil ends execution.
 // Returning an error triggers a retry with backoff.
 func (c *ToyController) Execute(ctx context.Context) error {

example/plugin-demo/demo-controller/controller.go

@@ -67,7 +67,7 @@ func (c *Controller) HandleDirective(
 	return nil, nil
 }
 
-// Execute executes the given controller.
+// Execute executes the controller goroutine.
 // Returning nil ends execution.
 // Returning an error triggers a retry with backoff.
 func (c *Controller) Execute(ctx context.Context) error {

plugin/loader/shared-library/filesystem/controller.go

@@ -51,7 +51,7 @@ func NewController(le *logrus.Entry, bus bus.Bus, conf *Config) (*Controller, er
 	}, nil
 }
 
-// Execute executes the given controller.
+// Execute executes the controller goroutine.
 // Returning nil ends execution.
 // Returning an error triggers a retry with backoff.
 func (c *Controller) Execute(ctx context.Context) error {