@@ -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 %}

@@ -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:

@@ -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

@@ -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