knife-client.mkd in chef-0.10.0.beta.9

- old
+ new

@@ -3,28 +3,14 @@
 
 ## SYNOPSIS
 
 __knife__ __client__ _sub-command_ _(options)_
 
-## DESCRIPTION
-Clients are identities used for communication with the Chef Server API,
-roughly equivalent to user accounts on the Chef Server, except that
-clients only communicate with the Chef Server API and are authenticated
-via request signatures.
+## SUB-COMMANDS
+Client subcommands follow a basic create, read, update, delete (CRUD)
+pattern. The Following subcommands are available:
 
-In the typical case, there will be one client object on the server for
-each node, and the corresponding client and node will have identical
-names.
-
-In the Chef authorization model, there is one special client, the
-"validator", which is authorized to create new non-administrative
-clients but has minimal privileges otherwise. This identity is used as a
-sort of "guest account" to create a client identity when initially
-setting up a host for management with Chef.
-
-## CLIENT SUB-COMMANDS
-
 ## BULK DELETE
 __knife client bulk delete__ _regex_ _(options)_
 
 Delete clients where the client name matches the regular expression
 _regex_ on the Chef Server. The regular expression should be given as a
@@ -83,9 +69,25 @@
 
   * `-a`, `--attribute ATTR`:
     Show only one attribute
 
 Show a client. Output format is determined by the --format option.
+
+## DESCRIPTION
+Clients are identities used for communication with the Chef Server API,
+roughly equivalent to user accounts on the Chef Server, except that
+clients only communicate with the Chef Server API and are authenticated
+via request signatures.
+
+In the typical case, there will be one client object on the server for
+each node, and the corresponding client and node will have identical
+names.
+
+In the Chef authorization model, there is one special client, the
+"validator", which is authorized to create new non-administrative
+clients but has minimal privileges otherwise. This identity is used as a
+sort of "guest account" to create a client identity when initially
+setting up a host for management with Chef.
 
 ## SEE ALSO
    __knife-node__(1)
 
 ## AUTHOR