docs: update command descriptions to be more descriptive (#256)

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

Author: chlins

cmd/attach.go

@@ -32,7 +32,7 @@ var attachConfig = config.NewAttach()
 // attachCmd represents the modctl command for attach.
 var attachCmd = &cobra.Command{
 	Use:                "attach [flags] <file>",
-	Short:              "A command line tool for modctl attach",
+	Short:              "Attach the file to an existing model artifact.",
 	Args:               cobra.ExactArgs(1),
 	DisableAutoGenTag:  true,
 	SilenceUsage:       true,

cmd/build.go

@@ -32,7 +32,7 @@ var buildConfig = config.NewBuild()
 // buildCmd represents the modctl command for build.
 var buildCmd = &cobra.Command{
 	Use:                "build [flags] <path>",
-	Short:              "A command line tool for modctl build",
+	Short:              "Build the model artifact with the context by specified path.",
 	Args:               cobra.ExactArgs(1),
 	DisableAutoGenTag:  true,
 	SilenceUsage:       true,

cmd/extract.go

@@ -32,7 +32,7 @@ var extractConfig = config.NewExtract()
 // extractCmd represents the modctl command for extract.
 var extractCmd = &cobra.Command{
 	Use:                "extract <target> --output <output>",
-	Short:              "A command line tool for modctl extract",
+	Short:              "Extract the model artifact to the output path, which can restore the initial state of the model files.",
 	Args:               cobra.ExactArgs(1),
 	DisableAutoGenTag:  true,
 	SilenceUsage:       true,

cmd/fetch.go

@@ -32,7 +32,7 @@ var fetchConfig = config.NewFetch()
 // fetchCmd represents the modctl command for fetch.
 var fetchCmd = &cobra.Command{
 	Use:                "fetch [flags] <target>",
-	Short:              "A command line tool for modctl fetch, please note that this command is designed for remote model fetching only.",
+	Short:              "Fetch can retrieve files from the remote model repository, enabling selective download of partial model files by filtering based on file path patterns.",
 	Args:               cobra.ExactArgs(1),
 	DisableAutoGenTag:  true,
 	SilenceUsage:       true,

cmd/inspect.go

@@ -33,7 +33,7 @@ var inspectConfig = config.NewInspect()
 // inspectCmd represents the modctl command for inspect.
 var inspectCmd = &cobra.Command{
 	Use:                "inspect [flags] <target>",
-	Short:              "A command line tool for modctl inspect",
+	Short:              "Inspect can help to analyze the composition of model artifact.",
 	Args:               cobra.ExactArgs(1),
 	DisableAutoGenTag:  true,
 	SilenceUsage:       true,

cmd/list.go

@@ -32,7 +32,7 @@ import (
 // listCmd represents the modctl command for list.
 var listCmd = &cobra.Command{
 	Use:                "ls",
-	Short:              "A command line tool for modctl list",
+	Short:              "List will lists the current built model artifacts from local storage.",
 	Args:               cobra.NoArgs,
 	DisableAutoGenTag:  true,
 	SilenceUsage:       true,

cmd/login.go

@@ -35,7 +35,7 @@ var loginConfig = config.NewLogin()
 // loginCmd represents the modctl command for login.
 var loginCmd = &cobra.Command{
 	Use:   "login [flags] <registry>",
-	Short: "A command line tool for modctl login",
+	Short: "Login to a registry.",
 	Example: `
 # login to docker hub:
 modctl login -u foo registry-1.docker.io

cmd/logout.go

@@ -29,7 +29,7 @@ import (
 // logoutCmd represents the modctl command for logout.
 var logoutCmd = &cobra.Command{
 	Use:                "logout [flags]",
-	Short:              "A command line tool for modctl logout",
+	Short:              "Logout from a registry.",
 	Args:               cobra.ExactArgs(1),
 	DisableAutoGenTag:  true,
 	SilenceUsage:       true,

cmd/prune.go

@@ -32,7 +32,7 @@ var pruneConfig = config.NewPrune()
 // pruneCmd represents the modctl command for prune.
 var pruneCmd = &cobra.Command{
 	Use:                "prune [flags]",
-	Short:              "A command line tool for modctl prune",
+	Short:              "Prune can help to cleanup useless manifests and blobs in the local storage.",
 	Args:               cobra.NoArgs,
 	DisableAutoGenTag:  true,
 	SilenceUsage:       true,

cmd/pull.go

@@ -32,7 +32,7 @@ var pullConfig = config.NewPull()
 // pullCmd represents the modctl command for pull.
 var pullCmd = &cobra.Command{
 	Use:                "pull [flags] <target>",
-	Short:              "A command line tool for modctl pull",
+	Short:              "Pull a model artifact from the remote registry.",
 	Args:               cobra.ExactArgs(1),
 	DisableAutoGenTag:  true,
 	SilenceUsage:       true,