autogen(docs): generate cli docs

docs/docs/cli/hydra-clients-create.md

@@ -9,25 +9,24 @@ This file is auto-generated.
 
 To improve this file please make your change against the appropriate "./cmd/*.go" file.
 -->
-
 ## hydra clients create
 
 Create a new OAuth 2.0 Client
 
 ### Synopsis
 
-This command creates an OAuth 2.0 Client which can be used to perform various
-OAuth 2.0 Flows like the Authorize Code, Implicit, Refresh flow.
+This command creates an OAuth 2.0 Client which can be used to perform various OAuth 2.0 Flows like
+the Authorize Code, Implicit, Refresh flow.
+
+ORY Hydra implements the OpenID Connect Dynamic Client registration specification. Most flags are supported by this command
+as well.
 
-ORY Hydra implements the OpenID Connect Dynamic Client registration
-specification. Most flags are supported by this command as well.
+Example:
+  hydra clients create -n "my app" -c http://localhost/cb -g authorization_code -r code -a core,foobar
 
-Example: hydra clients create -n "my app" -c http://localhost/cb -g
-authorization_code -r code -a core,foobar
+To encrypt auto generated client secret, use "--pgp-key", "--pgp-key-url" or "--keybase" flag, for example:
+  hydra clients create -n "my app" -g client_credentials -r token -a core,foobar --keybase keybase_username
 
-To encrypt auto generated client secret, use "--pgp-key", "--pgp-key-url" or
-"--keybase" flag, for example: hydra clients create -n "my app" -g
-client_credentials -r token -a core,foobar --keybase keybase_username
 
 ```
 hydra clients create [flags]
@@ -72,4 +71,5 @@ hydra clients create [flags]
 
 ### SEE ALSO
 
-- [hydra clients](hydra-clients) - Manage OAuth 2.0 Clients
+* [hydra clients](hydra-clients)	 - Manage OAuth 2.0 Clients
+

docs/docs/cli/hydra-clients-delete.md

@@ -9,7 +9,6 @@ This file is auto-generated.
 
 To improve this file please make your change against the appropriate "./cmd/*.go" file.
 -->
-
 ## hydra clients delete
 
 Delete an OAuth 2.0 Client
@@ -18,7 +17,8 @@ Delete an OAuth 2.0 Client
 
 This command deletes one or more OAuth 2.0 Clients by their respective IDs.
 
-Example: hydra clients delete client-1 client-2 client-3
+Example:
+  hydra clients delete client-1 client-2 client-3
 
 ```
 hydra clients delete <id> [<id>...] [flags]
@@ -43,4 +43,5 @@ hydra clients delete <id> [<id>...] [flags]
 
 ### SEE ALSO
 
-- [hydra clients](hydra-clients) - Manage OAuth 2.0 Clients
+* [hydra clients](hydra-clients)	 - Manage OAuth 2.0 Clients
+

docs/docs/cli/hydra-clients-get.md

@@ -9,7 +9,6 @@ This file is auto-generated.
 
 To improve this file please make your change against the appropriate "./cmd/*.go" file.
 -->
-
 ## hydra clients get
 
 Get an OAuth 2.0 Client
@@ -18,7 +17,8 @@ Get an OAuth 2.0 Client
 
 This command retrieves an OAuth 2.0 Clients by its ID.
 
-Example: hydra clients get client-1
+Example:
+  hydra clients get client-1
 
 ```
 hydra clients get <id> [flags]
@@ -43,4 +43,5 @@ hydra clients get <id> [flags]
 
 ### SEE ALSO
 
-- [hydra clients](hydra-clients) - Manage OAuth 2.0 Clients
+* [hydra clients](hydra-clients)	 - Manage OAuth 2.0 Clients
+

docs/docs/cli/hydra-clients-import.md

@@ -1,38 +1,38 @@
 ---
 id: hydra-clients-import
 title: hydra clients import
-description:
-  hydra clients import Import OAuth 2.0 Clients from one or more JSON files
+description: hydra clients import Import OAuth 2.0 Clients from one or more JSON files
 ---
 
 <!--
 This file is auto-generated.
 
 To improve this file please make your change against the appropriate "./cmd/*.go" file.
 -->
-
 ## hydra clients import
 
 Import OAuth 2.0 Clients from one or more JSON files
 
 ### Synopsis
 
-This command reads in each listed JSON file and imports their contents as OAuth
-2.0 Clients.
+This command reads in each listed JSON file and imports their contents as OAuth 2.0 Clients.
 
 The format for the JSON file is:
 
-{ "client_id": "...", "client_secret": "...", // ... all other fields of the
-OAuth 2.0 Client model are allowed here }
+{
+  "client_id": "...",
+  "client_secret": "...",
+  // ... all other fields of the OAuth 2.0 Client model are allowed here
+}
+
+Please be aware that this command does not update existing clients. If the client exists already, this command will fail.
 
-Please be aware that this command does not update existing clients. If the
-client exists already, this command will fail.
+Example:
+	hydra clients import client-1.json
 
-Example: hydra clients import client-1.json
+To encrypt auto generated client secret, use "--pgp-key", "--pgp-key-url" or "--keybase" flag, for example:
+	hydra clients import client-1.json --keybase keybase_username
 
-To encrypt auto generated client secret, use "--pgp-key", "--pgp-key-url" or
-"--keybase" flag, for example: hydra clients import client-1.json --keybase
-keybase_username
 
 ```
 hydra clients import <path/to/file.json> [<path/to/other/file.json>...] [flags]
@@ -60,4 +60,5 @@ hydra clients import <path/to/file.json> [<path/to/other/file.json>...] [flags]
 
 ### SEE ALSO
 
-- [hydra clients](hydra-clients) - Manage OAuth 2.0 Clients
+* [hydra clients](hydra-clients)	 - Manage OAuth 2.0 Clients
+

docs/docs/cli/hydra-clients-list.md

@@ -9,7 +9,6 @@ This file is auto-generated.
 
 To improve this file please make your change against the appropriate "./cmd/*.go" file.
 -->
-
 ## hydra clients list
 
 List OAuth 2.0 Clients
@@ -18,7 +17,8 @@ List OAuth 2.0 Clients
 
 This command list an OAuth 2.0 Clients.
 
-Example: hydra clients list
+Example:
+  hydra clients list
 
 ```
 hydra clients list [flags]
@@ -45,4 +45,5 @@ hydra clients list [flags]
 
 ### SEE ALSO
 
-- [hydra clients](hydra-clients) - Manage OAuth 2.0 Clients
+* [hydra clients](hydra-clients)	 - Manage OAuth 2.0 Clients
+

docs/docs/cli/hydra-clients-update.md

@@ -9,7 +9,6 @@ This file is auto-generated.
 
 To improve this file please make your change against the appropriate "./cmd/*.go" file.
 -->
-
 ## hydra clients update
 
 Update an entire OAuth 2.0 Client
@@ -18,17 +17,15 @@ Update an entire OAuth 2.0 Client
 
 This command replaces an OAuth 2.0 Client by its ID.
 
-Please be aware that this command replaces the entire client. To update only the
-name, a full client should be provided, for example: hydra clients update
-client-1 -n "my updated app" -c http://localhost/cb -g authorization_code -r
-code -a core,foobar
+Please be aware that this command replaces the entire client.
+To update only the name, a full client should be provided, for example:
+  hydra clients update client-1 -n "my updated app" -c http://localhost/cb -g authorization_code -r code -a core,foobar
+
+If only the name flag (-n "my updated app") is provided, the all other fields are updated to their default values.
 
-If only the name flag (-n "my updated app") is provided, the all other fields
-are updated to their default values.
+To encrypt auto generated client secret, use "--pgp-key", "--pgp-key-url" or "--keybase" flag, for example:
+  hydra clients update client-1 -n "my updated app" -g client_credentials -r token -a core,foobar --keybase keybase_username
 
-To encrypt auto generated client secret, use "--pgp-key", "--pgp-key-url" or
-"--keybase" flag, for example: hydra clients update client-1 -n "my updated app"
--g client_credentials -r token -a core,foobar --keybase keybase_username
 
 ```
 hydra clients update <id> [flags]
@@ -72,4 +69,5 @@ hydra clients update <id> [flags]
 
 ### SEE ALSO
 
-- [hydra clients](hydra-clients) - Manage OAuth 2.0 Clients
+* [hydra clients](hydra-clients)	 - Manage OAuth 2.0 Clients
+

docs/docs/cli/hydra-clients.md

@@ -9,7 +9,6 @@ This file is auto-generated.
 
 To improve this file please make your change against the appropriate "./cmd/*.go" file.
 -->
-
 ## hydra clients
 
 Manage OAuth 2.0 Clients
@@ -37,12 +36,11 @@ Manage OAuth 2.0 Clients
 
 ### SEE ALSO
 
-- [hydra](hydra) - Run and manage ORY Hydra
-- [hydra clients create](hydra-clients-create) - Create a new OAuth 2.0 Client
-- [hydra clients delete](hydra-clients-delete) - Delete an OAuth 2.0 Client
-- [hydra clients get](hydra-clients-get) - Get an OAuth 2.0 Client
-- [hydra clients import](hydra-clients-import) - Import OAuth 2.0 Clients from
-  one or more JSON files
-- [hydra clients list](hydra-clients-list) - List OAuth 2.0 Clients
-- [hydra clients update](hydra-clients-update) - Update an entire OAuth 2.0
-  Client
+* [hydra](hydra)	 - Run and manage ORY Hydra
+* [hydra clients create](hydra-clients-create)	 - Create a new OAuth 2.0 Client
+* [hydra clients delete](hydra-clients-delete)	 - Delete an OAuth 2.0 Client
+* [hydra clients get](hydra-clients-get)	 - Get an OAuth 2.0 Client
+* [hydra clients import](hydra-clients-import)	 - Import OAuth 2.0 Clients from one or more JSON files
+* [hydra clients list](hydra-clients-list)	 - List OAuth 2.0 Clients
+* [hydra clients update](hydra-clients-update)	 - Update an entire OAuth 2.0 Client
+

docs/docs/cli/hydra-keys-create.md

@@ -9,7 +9,6 @@ This file is auto-generated.
 
 To improve this file please make your change against the appropriate "./cmd/*.go" file.
 -->
-
 ## hydra keys create
 
 Create a new JSON Web Key Set
@@ -43,4 +42,5 @@ hydra keys create <set> <key> [flags]
 
 ### SEE ALSO
 
-- [hydra keys](hydra-keys) - Manage JSON Web Keys
+* [hydra keys](hydra-keys)	 - Manage JSON Web Keys
+

docs/docs/cli/hydra-keys-delete.md

@@ -9,7 +9,6 @@ This file is auto-generated.
 
 To improve this file please make your change against the appropriate "./cmd/*.go" file.
 -->
-
 ## hydra keys delete
 
 Delete a new JSON Web Key Set
@@ -41,4 +40,5 @@ hydra keys delete <set> [flags]
 
 ### SEE ALSO
 
-- [hydra keys](hydra-keys) - Manage JSON Web Keys
+* [hydra keys](hydra-keys)	 - Manage JSON Web Keys
+

docs/docs/cli/hydra-keys-get.md

@@ -9,7 +9,6 @@ This file is auto-generated.
 
 To improve this file please make your change against the appropriate "./cmd/*.go" file.
 -->
-
 ## hydra keys get
 
 Get a new JSON Web Key Set
@@ -41,4 +40,5 @@ hydra keys get <set> [flags]
 
 ### SEE ALSO
 
-- [hydra keys](hydra-keys) - Manage JSON Web Keys
+* [hydra keys](hydra-keys)	 - Manage JSON Web Keys
+

docs/docs/cli/hydra-keys-import.md

@@ -1,17 +1,14 @@
 ---
 id: hydra-keys-import
 title: hydra keys import
-description:
-  hydra keys import Imports cryptographic keys of any format to the JSON Web Key
-  Store
+description: hydra keys import Imports cryptographic keys of any format to the JSON Web Key Store
 ---
 
 <!--
 This file is auto-generated.
 
 To improve this file please make your change against the appropriate "./cmd/*.go" file.
 -->
-
 ## hydra keys import
 
 Imports cryptographic keys of any format to the JSON Web Key Store
@@ -20,15 +17,15 @@ Imports cryptographic keys of any format to the JSON Web Key Store
 
 This command allows you to import cryptographic keys to the JSON Web Key Store.
 
-Currently supported formats are raw JSON Web Keys or PEM/DER encoded data. If
-the JSON Web Key Set exists already, the imported keys will be added to that
-set. Otherwise, a new set will be created.
+Currently supported formats are raw JSON Web Keys or PEM/DER encoded data. If the JSON Web Key Set exists already,
+the imported keys will be added to that set. Otherwise, a new set will be created.
+
+Please be aware that importing a private key does not automatically import its public key as well.
 
-Please be aware that importing a private key does not automatically import its
-public key as well.
+Examples:
+	hydra keys import my-set ./path/to/jwk.json ./path/to/jwk-2.json
+	hydra keys import my-set ./path/to/rsa.key ./path/to/rsa.pub
 
-Examples: hydra keys import my-set ./path/to/jwk.json ./path/to/jwk-2.json hydra
-keys import my-set ./path/to/rsa.key ./path/to/rsa.pub
 
 ```
 hydra keys import <set> <file-1> [<file-2> [<file-3 [<...>]]] [flags]
@@ -54,4 +51,5 @@ hydra keys import <set> <file-1> [<file-2> [<file-3 [<...>]]] [flags]
 
 ### SEE ALSO
 
-- [hydra keys](hydra-keys) - Manage JSON Web Keys
+* [hydra keys](hydra-keys)	 - Manage JSON Web Keys
+

docs/docs/cli/hydra-keys.md

@@ -9,7 +9,6 @@ This file is auto-generated.
 
 To improve this file please make your change against the appropriate "./cmd/*.go" file.
 -->
-
 ## hydra keys
 
 Manage JSON Web Keys
@@ -37,9 +36,9 @@ Manage JSON Web Keys
 
 ### SEE ALSO
 
-- [hydra](hydra) - Run and manage ORY Hydra
-- [hydra keys create](hydra-keys-create) - Create a new JSON Web Key Set
-- [hydra keys delete](hydra-keys-delete) - Delete a new JSON Web Key Set
-- [hydra keys get](hydra-keys-get) - Get a new JSON Web Key Set
-- [hydra keys import](hydra-keys-import) - Imports cryptographic keys of any
-  format to the JSON Web Key Store
+* [hydra](hydra)	 - Run and manage ORY Hydra
+* [hydra keys create](hydra-keys-create)	 - Create a new JSON Web Key Set
+* [hydra keys delete](hydra-keys-delete)	 - Delete a new JSON Web Key Set
+* [hydra keys get](hydra-keys-get)	 - Get a new JSON Web Key Set
+* [hydra keys import](hydra-keys-import)	 - Imports cryptographic keys of any format to the JSON Web Key Store
+