Update the control loop interval flag description

cmd/flagger/main.go

@@ -37,7 +37,7 @@ func init() {
 	flag.StringVar(&kubeconfig, "kubeconfig", "", "Path to a kubeconfig. Only required if out-of-cluster.")
 	flag.StringVar(&masterURL, "master", "", "The address of the Kubernetes API server. Overrides any value in kubeconfig. Only required if out-of-cluster.")
 	flag.StringVar(&metricsServer, "metrics-server", "http://prometheus:9090", "Prometheus URL")
-	flag.DurationVar(&controlLoopInterval, "control-loop-interval", 10*time.Second, "wait interval between rollouts")
+	flag.DurationVar(&controlLoopInterval, "control-loop-interval", 10*time.Second, "Kubernetes API sync interval")
 	flag.StringVar(&logLevel, "log-level", "debug", "Log level can be: debug, info, warning, error.")
 	flag.StringVar(&port, "port", "8080", "Port to listen on.")
 	flag.StringVar(&slackURL, "slack-url", "", "Slack hook URL.")

docs/gitbook/how-it-works.md

@@ -154,7 +154,7 @@ You can determine the minimum time that it takes to validate and promote a canar
 interval * (maxWeight / stepWeight)
 ```
 
-And the time it takes for a canary to be rollback:
+And the time it takes for a canary to be rollback when the metrics or webhook checks are failing:
 
 ```
 interval * threshold 

pkg/controller/scheduler.go

@@ -17,6 +17,8 @@ func (c *Controller) scheduleCanaries() {
 
 	c.canaries.Range(func(key interface{}, value interface{}) bool {
 		canary := value.(*flaggerv1.Canary)
+
+		// format: <name>.<namespace>
 		name := key.(string)
 		current[name] = true