From 3a8f69ade7562c5753381ec33f9fba2d7ba07ff0 Mon Sep 17 00:00:00 2001
From: asyncapi-bot <bot+chan@asyncapi.io>
Date: Sun, 20 Oct 2024 17:29:27 +0200
Subject: [PATCH] docs(cli): update latest cli documentation (#3306)

---
 markdown/docs/tools/cli/usage.md | 66 ++++++++++++++++++--------------
 1 file changed, 38 insertions(+), 28 deletions(-)

diff --git a/markdown/docs/tools/cli/usage.md b/markdown/docs/tools/cli/usage.md
index 95669e0efd6..269d438fa4d 100644
--- a/markdown/docs/tools/cli/usage.md
+++ b/markdown/docs/tools/cli/usage.md
@@ -1,11 +1,11 @@
 ---
-title: 'Usage'
+title: "Usage"
 weight: 40
 ---
 
-<!-- 
+<!--
 
-This file is automatically generated from updateUsageDocs.js script. In package.json in line 158-161 lines the following steps has been executed in order to run this script successfully - 
+This file is automatically generated from updateUsageDocs.js script. In package.json in line 158-161 lines the following steps has been executed in order to run this script successfully -
 
 * generate:readme:create: It creates the initial content for the README file by printing the usage and commands tags using printf and redirects the output to scripts/README.md file.
 * generate:readme:commands: It changes the directory to the scripts folder and executes the oclif readme command. This command generates the usage and commands sections based on the CLI commands and updates the content in the scripts/README.md file.
@@ -19,9 +19,11 @@ This file is automatically generated from updateUsageDocs.js script. In package.
 -->
 
 The AsyncAPI CLI makes it easier to work with AsyncAPI documents.
+
 # Usage
 
 <!-- usage -->
+
 ```sh-session
 $ npm install -g @asyncapi/cli
 $ asyncapi COMMAND
@@ -33,36 +35,38 @@ USAGE
   $ asyncapi COMMAND
 ...
 ```
+
 <!-- usagestop -->
 
 # Commands
 
 <!-- commands -->
-* [`asyncapi bundle`](#asyncapi-bundle)
-* [`asyncapi config`](#asyncapi-config)
-* [`asyncapi config analytics`](#asyncapi-config-analytics)
-* [`asyncapi config context`](#asyncapi-config-context)
-* [`asyncapi config context add CONTEXT-NAME SPEC-FILE-PATH`](#asyncapi-config-context-add-context-name-spec-file-path)
-* [`asyncapi config context current`](#asyncapi-config-context-current)
-* [`asyncapi config context edit CONTEXT-NAME NEW-SPEC-FILE-PATH`](#asyncapi-config-context-edit-context-name-new-spec-file-path)
-* [`asyncapi config context init [CONTEXT-FILE-PATH]`](#asyncapi-config-context-init-context-file-path)
-* [`asyncapi config context list`](#asyncapi-config-context-list)
-* [`asyncapi config context remove CONTEXT-NAME`](#asyncapi-config-context-remove-context-name)
-* [`asyncapi config context use CONTEXT-NAME`](#asyncapi-config-context-use-context-name)
-* [`asyncapi config versions`](#asyncapi-config-versions)
-* [`asyncapi convert [SPEC-FILE]`](#asyncapi-convert-spec-file)
-* [`asyncapi diff OLD NEW`](#asyncapi-diff-old-new)
-* [`asyncapi generate`](#asyncapi-generate)
-* [`asyncapi generate fromTemplate ASYNCAPI TEMPLATE`](#asyncapi-generate-fromtemplate-asyncapi-template)
-* [`asyncapi generate models LANGUAGE FILE`](#asyncapi-generate-models-language-file)
-* [`asyncapi new`](#asyncapi-new)
-* [`asyncapi new file`](#asyncapi-new-file)
-* [`asyncapi new glee`](#asyncapi-new-glee)
-* [`asyncapi new template`](#asyncapi-new-template)
-* [`asyncapi optimize [SPEC-FILE]`](#asyncapi-optimize-spec-file)
-* [`asyncapi start`](#asyncapi-start)
-* [`asyncapi start studio`](#asyncapi-start-studio)
-* [`asyncapi validate [SPEC-FILE]`](#asyncapi-validate-spec-file)
+
+- [`asyncapi bundle`](#asyncapi-bundle)
+- [`asyncapi config`](#asyncapi-config)
+- [`asyncapi config analytics`](#asyncapi-config-analytics)
+- [`asyncapi config context`](#asyncapi-config-context)
+- [`asyncapi config context add CONTEXT-NAME SPEC-FILE-PATH`](#asyncapi-config-context-add-context-name-spec-file-path)
+- [`asyncapi config context current`](#asyncapi-config-context-current)
+- [`asyncapi config context edit CONTEXT-NAME NEW-SPEC-FILE-PATH`](#asyncapi-config-context-edit-context-name-new-spec-file-path)
+- [`asyncapi config context init [CONTEXT-FILE-PATH]`](#asyncapi-config-context-init-context-file-path)
+- [`asyncapi config context list`](#asyncapi-config-context-list)
+- [`asyncapi config context remove CONTEXT-NAME`](#asyncapi-config-context-remove-context-name)
+- [`asyncapi config context use CONTEXT-NAME`](#asyncapi-config-context-use-context-name)
+- [`asyncapi config versions`](#asyncapi-config-versions)
+- [`asyncapi convert [SPEC-FILE]`](#asyncapi-convert-spec-file)
+- [`asyncapi diff OLD NEW`](#asyncapi-diff-old-new)
+- [`asyncapi generate`](#asyncapi-generate)
+- [`asyncapi generate fromTemplate ASYNCAPI TEMPLATE`](#asyncapi-generate-fromtemplate-asyncapi-template)
+- [`asyncapi generate models LANGUAGE FILE`](#asyncapi-generate-models-language-file)
+- [`asyncapi new`](#asyncapi-new)
+- [`asyncapi new file`](#asyncapi-new-file)
+- [`asyncapi new glee`](#asyncapi-new-glee)
+- [`asyncapi new template`](#asyncapi-new-template)
+- [`asyncapi optimize [SPEC-FILE]`](#asyncapi-optimize-spec-file)
+- [`asyncapi start`](#asyncapi-start)
+- [`asyncapi start studio`](#asyncapi-start-studio)
+- [`asyncapi validate [SPEC-FILE]`](#asyncapi-validate-spec-file)
 
 ## `asyncapi bundle`
 
@@ -715,8 +719,13 @@ USAGE
   $ asyncapi start
 ```
 
+
+DESCRIPTION
+main command for starting asyncapi services, currently studio only.
+
 _See code: [src/commands/start/index.ts](https://github.com/asyncapi/cli/blob/v2.5.0/src/commands/start/index.ts)_
 
+
 ## `asyncapi start studio`
 
 starts a new local instance of Studio
@@ -765,4 +774,5 @@ DESCRIPTION
 ```
 
 _See code: [src/commands/validate.ts](https://github.com/asyncapi/cli/blob/v2.5.0/src/commands/validate.ts)_
+
 <!-- commandsstop -->