better

Author: yanxi0830

docs/cli_reference.md

@@ -2,8 +2,6 @@
 
 Welcome to the llama-stack-client CLI - a command-line interface for interacting with Llama Stack
 
-### Usage
-
 ```
 Usage: llama-stack-client [OPTIONS] COMMAND [ARGS]...
 ```
@@ -54,8 +52,6 @@ Usage: llama-stack-client [OPTIONS] COMMAND [ARGS]...
 
 Configure Llama Stack Client CLI.
 
-### Usage
-
 ```
 Usage: llama-stack-client configure [OPTIONS]
 ```
@@ -74,8 +70,6 @@ Usage: llama-stack-client configure [OPTIONS]
 
 Manage datasets.
 
-### Usage
-
 ```
 Usage: llama-stack-client datasets [OPTIONS] COMMAND [ARGS]...
 ```
@@ -96,8 +90,6 @@ Usage: llama-stack-client datasets [OPTIONS] COMMAND [ARGS]...
 
 Show available datasets on distribution endpoint
 
-### Usage
-
 ```
 Usage: llama-stack-client datasets list [OPTIONS]
 ```
@@ -112,8 +104,6 @@ Usage: llama-stack-client datasets list [OPTIONS]
 
 Create a new dataset
 
-### Usage
-
 ```
 Usage: llama-stack-client datasets register [OPTIONS]
 ```
@@ -142,8 +132,6 @@ Usage: llama-stack-client datasets register [OPTIONS]
 
 Run evaluation tasks.
 
-### Usage
-
 ```
 Usage: llama-stack-client eval [OPTIONS] COMMAND [ARGS]...
 ```
@@ -164,8 +152,6 @@ Usage: llama-stack-client eval [OPTIONS] COMMAND [ARGS]...
 
 Run a evaluation benchmark task
 
-### Usage
-
 ```
 Usage: llama-stack-client eval run-benchmark [OPTIONS] BENCHMARK_IDS...
 ```
@@ -200,8 +186,6 @@ Usage: llama-stack-client eval run-benchmark [OPTIONS] BENCHMARK_IDS...
 
 Run scoring from application datasets
 
-### Usage
-
 ```
 Usage: llama-stack-client eval run-scoring [OPTIONS] SCORING_FUNCTION_IDS...
 ```
@@ -232,8 +216,6 @@ Usage: llama-stack-client eval run-scoring [OPTIONS] SCORING_FUNCTION_IDS...
 
 Manage evaluation tasks.
 
-### Usage
-
 ```
 Usage: llama-stack-client eval-tasks [OPTIONS] COMMAND [ARGS]...
 ```
@@ -254,8 +236,6 @@ Usage: llama-stack-client eval-tasks [OPTIONS] COMMAND [ARGS]...
 
 Show available eval tasks on distribution endpoint
 
-### Usage
-
 ```
 Usage: llama-stack-client eval-tasks list [OPTIONS]
 ```
@@ -270,8 +250,6 @@ Usage: llama-stack-client eval-tasks list [OPTIONS]
 
 Register a new eval task
 
-### Usage
-
 ```
 Usage: llama-stack-client eval-tasks register [OPTIONS]
 ```
@@ -298,8 +276,6 @@ Usage: llama-stack-client eval-tasks register [OPTIONS]
 
 Inference (chat).
 
-### Usage
-
 ```
 Usage: llama-stack-client inference [OPTIONS] COMMAND [ARGS]...
 ```
@@ -318,8 +294,6 @@ Usage: llama-stack-client inference [OPTIONS] COMMAND [ARGS]...
 
 Show available inference chat completion endpoints on distribution endpoint
 
-### Usage
-
 ```
 Usage: llama-stack-client inference chat-completion [OPTIONS]
 ```
@@ -342,8 +316,6 @@ Usage: llama-stack-client inference chat-completion [OPTIONS]
 
 Inspect server configuration.
 
-### Usage
-
 ```
 Usage: llama-stack-client inspect [OPTIONS] COMMAND [ARGS]...
 ```
@@ -362,8 +334,6 @@ Usage: llama-stack-client inspect [OPTIONS] COMMAND [ARGS]...
 
 Show available providers on distribution endpoint
 
-### Usage
-
 ```
 Usage: llama-stack-client inspect version [OPTIONS]
 ```
@@ -378,8 +348,6 @@ Usage: llama-stack-client inspect version [OPTIONS]
 
 Manage GenAI models.
 
-### Usage
-
 ```
 Usage: llama-stack-client models [OPTIONS] COMMAND [ARGS]...
 ```
@@ -404,8 +372,6 @@ Usage: llama-stack-client models [OPTIONS] COMMAND [ARGS]...
 
 Show available llama models at distribution endpoint
 
-### Usage
-
 ```
 Usage: llama-stack-client models get [OPTIONS] MODEL_ID
 ```
@@ -424,8 +390,6 @@ Usage: llama-stack-client models get [OPTIONS] MODEL_ID
 
 Show available llama models at distribution endpoint
 
-### Usage
-
 ```
 Usage: llama-stack-client models list [OPTIONS]
 ```
@@ -440,8 +404,6 @@ Usage: llama-stack-client models list [OPTIONS]
 
 Register a new model at distribution endpoint
 
-### Usage
-
 ```
 Usage: llama-stack-client models register [OPTIONS] MODEL_ID
 ```
@@ -466,8 +428,6 @@ Usage: llama-stack-client models register [OPTIONS] MODEL_ID
 
 Unregister a model from distribution endpoint
 
-### Usage
-
 ```
 Usage: llama-stack-client models unregister [OPTIONS] MODEL_ID
 ```
@@ -486,8 +446,6 @@ Usage: llama-stack-client models unregister [OPTIONS] MODEL_ID
 
 Post-training.
 
-### Usage
-
 ```
 Usage: llama-stack-client post-training [OPTIONS] COMMAND [ARGS]...
 ```
@@ -514,8 +472,6 @@ Usage: llama-stack-client post-training [OPTIONS] COMMAND [ARGS]...
 
 Get the training artifacts of a specific post training job
 
-### Usage
-
 ```
 Usage: llama-stack-client post-training artifacts [OPTIONS]
 ```
@@ -532,8 +488,6 @@ Usage: llama-stack-client post-training artifacts [OPTIONS]
 
 Cancel the training job
 
-### Usage
-
 ```
 Usage: llama-stack-client post-training cancel [OPTIONS]
 ```
@@ -550,8 +504,6 @@ Usage: llama-stack-client post-training cancel [OPTIONS]
 
 Show the list of available post training jobs
 
-### Usage
-
 ```
 Usage: llama-stack-client post-training list [OPTIONS]
 ```
@@ -566,8 +518,6 @@ Usage: llama-stack-client post-training list [OPTIONS]
 
 Show the status of a specific post training job
 
-### Usage
-
 ```
 Usage: llama-stack-client post-training status [OPTIONS]
 ```
@@ -584,8 +534,6 @@ Usage: llama-stack-client post-training status [OPTIONS]
 
 Kick off a supervised fine tune job
 
-### Usage
-
 ```
 Usage: llama-stack-client post-training supervised_fine_tune 
            [OPTIONS]
@@ -611,8 +559,6 @@ Usage: llama-stack-client post-training supervised_fine_tune
 
 Manage API providers.
 
-### Usage
-
 ```
 Usage: llama-stack-client providers [OPTIONS] COMMAND [ARGS]...
 ```
@@ -631,8 +577,6 @@ Usage: llama-stack-client providers [OPTIONS] COMMAND [ARGS]...
 
 Show available providers on distribution endpoint
 
-### Usage
-
 ```
 Usage: llama-stack-client providers list [OPTIONS]
 ```
@@ -647,8 +591,6 @@ Usage: llama-stack-client providers list [OPTIONS]
 
 Manage scoring functions.
 
-### Usage
-
 ```
 Usage: llama-stack-client scoring-functions [OPTIONS] COMMAND [ARGS]...
 ```
@@ -669,8 +611,6 @@ Usage: llama-stack-client scoring-functions [OPTIONS] COMMAND [ARGS]...
 
 Show available scoring functions on distribution endpoint
 
-### Usage
-
 ```
 Usage: llama-stack-client scoring-functions list [OPTIONS]
 ```
@@ -685,8 +625,6 @@ Usage: llama-stack-client scoring-functions list [OPTIONS]
 
 Register a new scoring function
 
-### Usage
-
 ```
 Usage: llama-stack-client scoring-functions register [OPTIONS]
 ```
@@ -713,8 +651,6 @@ Usage: llama-stack-client scoring-functions register [OPTIONS]
 
 Manage safety shield services.
 
-### Usage
-
 ```
 Usage: llama-stack-client shields [OPTIONS] COMMAND [ARGS]...
 ```
@@ -735,8 +671,6 @@ Usage: llama-stack-client shields [OPTIONS] COMMAND [ARGS]...
 
 Show available safety shields on distribution endpoint
 
-### Usage
-
 ```
 Usage: llama-stack-client shields list [OPTIONS]
 ```
@@ -751,8 +685,6 @@ Usage: llama-stack-client shields list [OPTIONS]
 
 Register a new safety shield
 
-### Usage
-
 ```
 Usage: llama-stack-client shields register [OPTIONS]
 ```
@@ -775,8 +707,6 @@ Usage: llama-stack-client shields register [OPTIONS]
 
 Manage available tool groups.
 
-### Usage
-
 ```
 Usage: llama-stack-client toolgroups [OPTIONS] COMMAND [ARGS]...
 ```
@@ -801,8 +731,6 @@ Usage: llama-stack-client toolgroups [OPTIONS] COMMAND [ARGS]...
 
 Show available llama toolgroups at distribution endpoint
 
-### Usage
-
 ```
 Usage: llama-stack-client toolgroups get [OPTIONS] TOOLGROUP_ID
 ```
@@ -821,8 +749,6 @@ Usage: llama-stack-client toolgroups get [OPTIONS] TOOLGROUP_ID
 
 Show available llama toolgroups at distribution endpoint
 
-### Usage
-
 ```
 Usage: llama-stack-client toolgroups list [OPTIONS]
 ```
@@ -837,8 +763,6 @@ Usage: llama-stack-client toolgroups list [OPTIONS]
 
 Register a new toolgroup at distribution endpoint
 
-### Usage
-
 ```
 Usage: llama-stack-client toolgroups register [OPTIONS] TOOLGROUP_ID
 ```
@@ -865,8 +789,6 @@ Usage: llama-stack-client toolgroups register [OPTIONS] TOOLGROUP_ID
 
 Unregister a toolgroup from distribution endpoint
 
-### Usage
-
 ```
 Usage: llama-stack-client toolgroups unregister [OPTIONS] TOOLGROUP_ID
 ```
@@ -885,8 +807,6 @@ Usage: llama-stack-client toolgroups unregister [OPTIONS] TOOLGROUP_ID
 
 Manage vector databases.
 
-### Usage
-
 ```
 Usage: llama-stack-client vector-dbs [OPTIONS] COMMAND [ARGS]...
 ```
@@ -909,8 +829,6 @@ Usage: llama-stack-client vector-dbs [OPTIONS] COMMAND [ARGS]...
 
 Show available vector dbs on distribution endpoint
 
-### Usage
-
 ```
 Usage: llama-stack-client vector-dbs list [OPTIONS]
 ```
@@ -925,8 +843,6 @@ Usage: llama-stack-client vector-dbs list [OPTIONS]
 
 Create a new vector db
 
-### Usage
-
 ```
 Usage: llama-stack-client vector-dbs register [OPTIONS] VECTOR_DB_ID
 ```
@@ -953,8 +869,6 @@ Usage: llama-stack-client vector-dbs register [OPTIONS] VECTOR_DB_ID
 
 Delete a vector db
 
-### Usage
-
 ```
 Usage: llama-stack-client vector-dbs unregister [OPTIONS] VECTOR_DB_ID
 ```

scripts/gen_cli_doc.py

@@ -27,7 +27,6 @@ def generate_markdown_docs(command, parent=None, level=1):
         doc.append(f"{command.help}\n")
 
     # Add usage
-    doc.append("### Usage\n")
     doc.append(f"```\n{command.get_usage(ctx)}\n```\n")
 
     # Add options if present