autogen(docs): generate cli docs

Author: ory-bot

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

@@ -9,26 +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]
@@ -76,4 +74,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/hydra/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]
@@ -42,4 +42,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/hydra/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]
@@ -42,4 +42,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/hydra/cli/hydra-clients-import.md

@@ -1,36 +1,31 @@
 ---
 id: hydra-clients-import
 title: hydra clients import
-description:
-  hydra clients import Imports OAuth 2.0 Clients from one or more JSON files to
-  the JSON Web Key Store
+description: hydra clients import Imports OAuth 2.0 Clients from one or more JSON files 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 clients import
 
 Imports OAuth 2.0 Clients from one or more JSON files to the JSON Web Key Store
 
 ### Synopsis
 
-This command allows you to import OAuth 2.0 Clients from one or more JSON files
-to the JSON Web Key Store.
+This command allows you to import OAuth 2.0 Clients from one or more JSON files 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 --default-key-id cae6b214-fb1e-4ebc-9019-95286a62eabc
 
-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 --default-key-id
-cae6b214-fb1e-4ebc-9019-95286a62eabc
 
 ```
 hydra clients import &lt;set&gt; &lt;file-1&gt; [&lt;file-2&gt; [&lt;file-3 [&lt;...&gt;]]] [flags]
@@ -56,4 +51,5 @@ hydra clients import &lt;set&gt; &lt;file-1&gt; [&lt;file-2&gt; [&lt;file-3 [&lt
 
 ### SEE ALSO
 
-- [hydra clients](hydra-clients) - Manage OAuth 2.0 Clients
+* [hydra clients](hydra-clients)	 - Manage OAuth 2.0 Clients
+

docs/hydra/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]
@@ -44,4 +44,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/hydra/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,18 +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]
@@ -76,4 +72,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/hydra/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
@@ -27,18 +26,14 @@ 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 import](hydra-clients-import) - Import OAuth 2.0 Clients from
-  one or more JSON files
-- [hydra clients import](hydra-clients-import) - Imports OAuth 2.0 Clients from
-  one or more JSON files to the JSON Web Key Store
-- [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 import](hydra-clients-import)	 - Import OAuth 2.0 Clients from one or more JSON files
+* [hydra clients import](hydra-clients-import)	 - Imports OAuth 2.0 Clients from one or more JSON files to the JSON Web Key Store
+* [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/hydra/cli/hydra-janitor.md

@@ -1,68 +1,63 @@
 ---
 id: hydra-janitor
 title: hydra janitor
-description:
-  hydra janitor Clean the database of old tokens, login/consent requests and jwt
-  grant issuers
+description: hydra janitor Clean the database of old tokens, login/consent requests and jwt grant issuers
 ---
 
 <!--
 This file is auto-generated.
 
 To improve this file please make your change against the appropriate "./cmd/*.go" file.
 -->
-
 ## hydra janitor
 
 Clean the database of old tokens, login/consent requests and jwt grant issuers
 
 ### Synopsis
 
-This command will cleanup any expired oauth2 tokens as well as login/consent
-requests. This will select records to delete with a limit and delete records in
-batch to ensure that no table locking issues arise in big production databases.
+This command will cleanup any expired oauth2 tokens as well as login/consent requests.
+This will select records to delete with a limit and delete records in batch to ensure that no table locking issues arise in big production databases.
 
-### Warning
+### Warning ###
 
 This command is in beta. Proceed with caution!
 
 This is a destructive command and will purge data directly from the database.
-Please use this command with caution if you need to keep historic data for any
-reason.
+Please use this command with caution if you need to keep historic data for any reason.
 
 ###############
 
 Janitor can be used in several ways.
 
-1.  By passing the database connection string (DSN) as an argument Pass the
-    database url (dsn) as an argument to janitor. E.g. janitor
-    &lt;database-url&gt;
-2.  By passing the DSN as an environment variable
+1. By passing the database connection string (DSN) as an argument
+   Pass the database url (dsn) as an argument to janitor. E.g. janitor &lt;database-url&gt;
+2. By passing the DSN as an environment variable
 
-        export DSN=...
-        janitor -e
+		export DSN=...
+		janitor -e
 
-3.  By passing a configuration file containing the DSN janitor -c
-    /path/to/conf.yml
-4.  Extra _optional_ parameters can also be added such as
+3. By passing a configuration file containing the DSN
+   janitor -c /path/to/conf.yml
+4. Extra *optional* parameters can also be added such as
 
-        janitor --keep-if-younger 23h --access-lifespan 1h --refresh-lifespan 40h --consent-request-lifespan 10m &lt;database-url&gt;
+		janitor --keep-if-younger 23h --access-lifespan 1h --refresh-lifespan 40h --consent-request-lifespan 10m &lt;database-url&gt;
 
-5.  Running only a certain cleanup
+5. Running only a certain cleanup
 
-        janitor --tokens &lt;database-url&gt;
+		janitor --tokens &lt;database-url&gt;
 
-    or
+   or
 
-        janitor --requests &lt;database-url&gt;
+		janitor --requests &lt;database-url&gt;
 
     or
 
-        janitor --grants &lt;database-url&gt;
+		janitor --grants &lt;database-url&gt;
 
-    or any combination of them
+   or any combination of them
+
+		janitor --tokens --requests --grants &lt;database-url&gt;
 
-        janitor --tokens --requests --grants &lt;database-url&gt;
 
 ```
 hydra janitor [&lt;database-url&gt;] [flags]
@@ -87,4 +82,5 @@ hydra janitor [&lt;database-url&gt;] [flags]
 
 ### SEE ALSO
 
-- [hydra](hydra) - Run and manage Ory Hydra
+* [hydra](hydra)	 - Run and manage Ory Hydra
+

docs/hydra/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
@@ -38,4 +37,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/hydra/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
@@ -36,4 +35,5 @@ hydra keys delete <set> [flags]
 
 ### SEE ALSO
 
-- [hydra keys](hydra-keys) - Manage JSON Web Keys
+* [hydra keys](hydra-keys)	 - Manage JSON Web Keys
+