doc review updates

Signed-off-by: Evan Hazlett <ejhazlett@gmail.com>

docs/reference/commandline/secret_inspect.md

@@ -71,8 +71,8 @@ $ docker secret inspect mhv17xfe3gh6xc4rij5orpfds
 
 ### Formatting secret output
 
-The `--format` option can be used to obtain specific information about a
-secret. For example, the following command outputs the digest of the
+You can use the --format option to obtain specific information about a
+secret. The following example command outputs the digest of the
 secret.
 
 ```bash{% raw %}

docs/reference/commandline/secret_ls.md

@@ -27,8 +27,7 @@ Options:
   -q, --quiet          Only display IDs
 ```
 
-This command when run targeting a manager, lists secrets in the
-swarm.
+Run this command from a manager to list the secrets in the Swarm.
 
 On a manager node:
 

docs/reference/commandline/secret_rm.md

@@ -30,7 +30,7 @@ Options:
 Removes the specified secrets from the swarm. This command has to be run
 targeting a manager node.
 
-For example, to remove secret:
+This example removes a secret:
 
 ```bash
 $ docker secret rm sapth4csdo5b6wz2p5uimh5xg

docs/reference/commandline/service_create.md

@@ -121,8 +121,9 @@ ID            NAME   MODE        REPLICAS  IMAGE
 ```
 
 ### Create a service with secrets
-Use the `--secret` flag to use a [secret](secret_create.md).  The following
-command will create a service with two secrets named `ssh-key` and `app-key`:
+Use the `--secret` flag to give a container access to a
+[secret](secret_create.md).  The following command will create a service
+with two secrets named `ssh-key` and `app-key`:
 
 ```bash
 $ docker service create --name redis --secret ssh-key:ssh --secret app-key:app redis:3.0.6