docs: update kcl cli reference documents

Signed-off-by: peefy <[email protected]>

Author: Peefy

docs/tools/cli/kcl/docgen.md

@@ -95,7 +95,7 @@ Refer to [reST](https://docutils.sourceforge.io/rst.html) for more information.
 ### kcl doc
 
 ```shell
-This command shows documentation for KCL package or symbol.
+This command shows documentation for KCL modules or symbols.
 
 Usage:
   kcl doc [command]
@@ -107,7 +107,6 @@ Examples:
   # Generate document for current package
   kcl doc generate
 
-
 Available Commands:
   generate    Generates documents from code and examples
 
@@ -120,6 +119,8 @@ Use "kcl doc [command] --help" for more information about a command.
 ### kcl doc generate
 
 ```shell
+This command generates documents for KCL modules.
+
 Usage:
   kcl doc generate [flags]
 
@@ -139,7 +140,6 @@ Examples:
   # Generate Markdown document for specific package to a <target directory>
   kcl doc generate --file-path <package path> --target <target directory>
 
-
 Flags:
       --escape-html         Whether to escape html symbols when the output format is markdown. Always scape when the output format is html. Default to false.
       --file-path string    Relative or absolute path to the KCL package root when running kcl-doc command from

docs/tools/cli/kcl/lint.md

@@ -51,16 +51,15 @@ Examples:
 
   # Lint multiple files
   kcl lint path/to/kcl1.k path/to/kcl2.k
-
+  
   # Lint OCI packages
-  kcl lint oci://ghcr.io/kcl-lang/hello-world
-
+  kcl lint oci://ghcr.io/kcl-lang/helloworld
+  
   # Lint the current package
   kcl lint
 
-
 Flags:
-  -D, --argument strings        Specify the top-level argument
+  -D, --argument stringArray    Specify the top-level argument
   -d, --debug                   Run in debug mode
   -n, --disable_none            Disable dumping None values
   -E, --external strings        Specify the mapping of package name and path where the package is located
@@ -72,6 +71,7 @@ Flags:
   -S, --path_selector strings   Specify the path selectors
   -q, --quiet                   Set the quiet mode (no output)
   -Y, --setting strings         Specify the command line setting files
+  -H, --show_hidden             Display hidden attributes
   -k, --sort_keys               Sort output result keys
   -r, --strict_range_check      Do perform strict numeric range checks
   -t, --tag string              Specify the tag for the OCI or Git artifact

docs/tools/cli/kcl/overview.md

@@ -27,6 +27,12 @@ KCL toolchain is a toolset of KCL language, which aims to improve the efficiency
 ## Args
 
 ```shell
+The KCL Command Line Interface (CLI).
+
+KCL is an open-source, constraint-based record and functional language that
+enhances the writing of complex configurations, including those for cloud-native
+scenarios. The KCL website: https://kcl-lang.io
+
 Usage:
   kcl [command]
 
@@ -35,8 +41,9 @@ Available Commands:
   completion  Generate the autocompletion script for the specified shell
   doc         KCL document tool
   fmt         KCL format tool
+  help        Help about any command
   import      KCL import tool
-  lint        Run KCL codes.
+  lint        Lint KCL codes.
   mod         KCL module management
   play        Open the kcl playground in the browser.
   registry    KCL registry management
@@ -50,8 +57,5 @@ Flags:
   -h, --help      help for kcl
   -v, --version   version for kcl
 
-Additional help topics:
-  kcl
-
 Use "kcl [command] --help" for more information about a command.
 ```

docs/tools/cli/kcl/run.md

@@ -9,6 +9,10 @@ This command runs the kcl code and displays the output. 'kcl run' takes multiple
 ## Args
 
 ```shell
+This command runs the kcl code and displays the output. 'kcl run' takes multiple input for arguments.
+
+For example, 'kcl run path/to/kcl.k' will run the file named path/to/kcl.k
+
 Usage:
   kcl run [flags]
 
@@ -24,16 +28,18 @@ Examples:
 
   # Run multiple files
   kcl run path/to/kcl1.k path/to/kcl2.k
-
+  
   # Run OCI packages
-  kcl run oci://ghcr.io/kcl-lang/hello-world
+  kcl run oci://ghcr.io/kcl-lang/helloworld
+  
+  # Run remote Git repo
+  kcl run https://github.com/kcl-lang/flask-demo-kcl-manifests
 
   # Run the current package
   kcl run
 
-
 Flags:
-  -D, --argument strings        Specify the top-level argument
+  -D, --argument stringArray    Specify the top-level argument
   -d, --debug                   Run in debug mode
   -n, --disable_none            Disable dumping None values
   -E, --external strings        Specify the mapping of package name and path where the package is located
@@ -45,6 +51,7 @@ Flags:
   -S, --path_selector strings   Specify the path selectors
   -q, --quiet                   Set the quiet mode (no output)
   -Y, --setting strings         Specify the command line setting files
+  -H, --show_hidden             Display hidden attributes
   -k, --sort_keys               Sort output result keys
   -r, --strict_range_check      Do perform strict numeric range checks
   -t, --tag string              Specify the tag for the OCI or Git artifact

docs/tools/cli/package-management/command-reference/12.graph.md

@@ -0,0 +1,27 @@
+# kcl mod graph
+
+Print the module dependency graph. Each module is identified as a string of the form path@version.
+
+## Usage
+
+```shell
+kcl mod graph [flags]
+```
+
+## Description
+
+`kcl mod graph` will print the module dependency graph. Each module is identified as a string of the form path@version.
+
+## Options
+
+### --help, -h
+
+Show help for `kcl mod graph` command.
+
+## Examples
+
+### Print the current module dependency graph.
+
+```shell
+kcl mod graph
+```

docs/user_docs/support/faq-kcl.md

@@ -2551,7 +2551,7 @@ final_list:
 
 The first `"v1"` over here denotes that the type of the variable `version` is of string literal type. The second `"v1"` denotes that the default value of the variable `version` is `"v1"`.
 
-## 62. How do i define a schema to verify the contents of a given JSON file?
+## 62. How to define a schema to verify the contents of a given JSON file?
 
 We can use the kcl `vet` tool to validate the JSON data in a given JSOn file. For example, in the below data.json file we use the KCL file(schema.k) below to validate the `age` parameter. 
 

i18n/zh-CN/docusaurus-plugin-content-docs/current/tools/cli/kcl/docgen.md

@@ -95,7 +95,7 @@ kcl doc generate --file-path <package path> --target <target directory>
 ### kcl doc
 
 ```shell
-This command shows documentation for KCL package or symbol.
+This command shows documentation for KCL modules or symbols.
 
 Usage:
   kcl doc [command]
@@ -107,7 +107,6 @@ Examples:
   # Generate document for current package
   kcl doc generate
 
-
 Available Commands:
   generate    Generates documents from code and examples
 
@@ -120,6 +119,8 @@ Use "kcl doc [command] --help" for more information about a command.
 ### kcl doc generate
 
 ```shell
+This command generates documents for KCL modules.
+
 Usage:
   kcl doc generate [flags]
 
@@ -139,7 +140,6 @@ Examples:
   # Generate Markdown document for specific package to a <target directory>
   kcl doc generate --file-path <package path> --target <target directory>
 
-
 Flags:
       --escape-html         Whether to escape html symbols when the output format is markdown. Always scape when the output format is html. Default to false.
       --file-path string    Relative or absolute path to the KCL package root when running kcl-doc command from

i18n/zh-CN/docusaurus-plugin-content-docs/current/tools/cli/kcl/lint.md

@@ -51,16 +51,15 @@ Examples:
 
   # Lint multiple files
   kcl lint path/to/kcl1.k path/to/kcl2.k
-
+  
   # Lint OCI packages
-  kcl lint oci://ghcr.io/kcl-lang/hello-world
-
+  kcl lint oci://ghcr.io/kcl-lang/helloworld
+  
   # Lint the current package
   kcl lint
 
-
 Flags:
-  -D, --argument strings        Specify the top-level argument
+  -D, --argument stringArray    Specify the top-level argument
   -d, --debug                   Run in debug mode
   -n, --disable_none            Disable dumping None values
   -E, --external strings        Specify the mapping of package name and path where the package is located
@@ -72,6 +71,7 @@ Flags:
   -S, --path_selector strings   Specify the path selectors
   -q, --quiet                   Set the quiet mode (no output)
   -Y, --setting strings         Specify the command line setting files
+  -H, --show_hidden             Display hidden attributes
   -k, --sort_keys               Sort output result keys
   -r, --strict_range_check      Do perform strict numeric range checks
   -t, --tag string              Specify the tag for the OCI or Git artifact

i18n/zh-CN/docusaurus-plugin-content-docs/current/tools/cli/kcl/overview.md

@@ -27,6 +27,12 @@ KCL 工具链是 KCL 语言的工具集合，旨在提升 KCL 的批量迁移、
 ## 参数说明
 
 ```shell
+The KCL Command Line Interface (CLI).
+
+KCL is an open-source, constraint-based record and functional language that
+enhances the writing of complex configurations, including those for cloud-native
+scenarios. The KCL website: https://kcl-lang.io
+
 Usage:
   kcl [command]
 
@@ -35,8 +41,9 @@ Available Commands:
   completion  Generate the autocompletion script for the specified shell
   doc         KCL document tool
   fmt         KCL format tool
+  help        Help about any command
   import      KCL import tool
-  lint        Run KCL codes.
+  lint        Lint KCL codes.
   mod         KCL module management
   play        Open the kcl playground in the browser.
   registry    KCL registry management
@@ -50,8 +57,5 @@ Flags:
   -h, --help      help for kcl
   -v, --version   version for kcl
 
-Additional help topics:
-  kcl
-
 Use "kcl [command] --help" for more information about a command.
 ```

i18n/zh-CN/docusaurus-plugin-content-docs/current/tools/cli/kcl/run.md

@@ -7,6 +7,10 @@ sidebar_position: 1
 ## 参数说明
 
 ```shell
+This command runs the kcl code and displays the output. 'kcl run' takes multiple input for arguments.
+
+For example, 'kcl run path/to/kcl.k' will run the file named path/to/kcl.k
+
 Usage:
   kcl run [flags]
 
@@ -22,16 +26,18 @@ Examples:
 
   # Run multiple files
   kcl run path/to/kcl1.k path/to/kcl2.k
-
+  
   # Run OCI packages
-  kcl run oci://ghcr.io/kcl-lang/hello-world
+  kcl run oci://ghcr.io/kcl-lang/helloworld
+  
+  # Run remote Git repo
+  kcl run https://github.com/kcl-lang/flask-demo-kcl-manifests
 
   # Run the current package
   kcl run
 
-
 Flags:
-  -D, --argument strings        Specify the top-level argument
+  -D, --argument stringArray    Specify the top-level argument
   -d, --debug                   Run in debug mode
   -n, --disable_none            Disable dumping None values
   -E, --external strings        Specify the mapping of package name and path where the package is located
@@ -43,7 +49,9 @@ Flags:
   -S, --path_selector strings   Specify the path selectors
   -q, --quiet                   Set the quiet mode (no output)
   -Y, --setting strings         Specify the command line setting files
+  -H, --show_hidden             Display hidden attributes
   -k, --sort_keys               Sort output result keys
   -r, --strict_range_check      Do perform strict numeric range checks
-  -t, --tag string              Specify the tag fo
+  -t, --tag string              Specify the tag for the OCI or Git artifact
+  -V, --vendor                  Run in vendor mode
 ```

i18n/zh-CN/docusaurus-plugin-content-docs/current/tools/cli/package-management/command-reference/11.update.md

@@ -0,0 +1,23 @@
+# kcl mod update
+
+kcl mod update 将根据 kcl.mod 更新在 kcl.mod.lock 中列出的依赖项。也可以通过指定包的路径来更新一个包。
+
+## 使用
+
+```shell
+kcl mod update [options][module_name]
+```
+
+## 示例
+
+### 更新当前模块
+
+```shell
+kcl mod update
+```
+
+### 更新指定路径的模块
+
+```shell
+kcl mod update path/to/package
+```

i18n/zh-CN/docusaurus-plugin-content-docs/current/tools/cli/package-management/command-reference/12.graph.md

@@ -0,0 +1,17 @@
+# kcl mod update
+
+打印模块依赖关系图。每个模块都以 `path@version` 的形式标识进行输出
+
+## 使用
+
+```shell
+kcl mod graph [flags]
+```
+
+## 示例
+
+### 打印当前模块的依赖关系图
+
+```shell
+kcl mod graph
+```

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.8/tools/cli/kcl/docgen.md

@@ -95,7 +95,7 @@ kcl doc generate --file-path <package path> --target <target directory>
 ### kcl doc
 
 ```shell
-This command shows documentation for KCL package or symbol.
+This command shows documentation for KCL modules or symbols.
 
 Usage:
   kcl doc [command]
@@ -107,7 +107,6 @@ Examples:
   # Generate document for current package
   kcl doc generate
 
-
 Available Commands:
   generate    Generates documents from code and examples
 
@@ -120,6 +119,8 @@ Use "kcl doc [command] --help" for more information about a command.
 ### kcl doc generate
 
 ```shell
+This command generates documents for KCL modules.
+
 Usage:
   kcl doc generate [flags]
 
@@ -139,7 +140,6 @@ Examples:
   # Generate Markdown document for specific package to a <target directory>
   kcl doc generate --file-path <package path> --target <target directory>
 
-
 Flags:
       --escape-html         Whether to escape html symbols when the output format is markdown. Always scape when the output format is html. Default to false.
       --file-path string    Relative or absolute path to the KCL package root when running kcl-doc command from