command/intention: address comment feedback

command/intention/create/create.go

@@ -92,7 +92,7 @@ func (c *cmd) Run(args []string) int {
 
 	// Go through and create each intention
 	for _, ixn := range ixns {
-		// If replace is set to true, then find this intention and delete it.
+		// If replace is set to true, then perform an update operation.
 		if c.flagReplace {
 			oldIxn, err := find.Find(ixn.SourceString(), ixn.DestinationString())
 			if err != nil {

command/intention/finder/finder.go

@@ -13,6 +13,10 @@ import (
 // caches them once, and searches in-memory for this. For now this works since
 // even with a very large number of intentions, the size of the data gzipped
 // over HTTP will be relatively small.
+//
+// The Finder will only downlaod the intentions one time. This struct is
+// not expected to be used over a long period of time. Though it may be
+// reused multile times, the intentions list is only downloaded once.
 type Finder struct {
 	// Client is the API client to use for any requests.
 	Client *api.Client

command/intention/intention.go

@@ -28,7 +28,7 @@ const help = `
 Usage: consul intention <subcommand> [options] [args]
 
   This command has subcommands for interacting with intentions. Intentions
-  are the permissions for what services are allowed to communicate via
+  are permissions describing which services are allowed to communicate via
   Connect. Here are some simple examples, and more detailed examples are
   available in the subcommands or the documentation.