docs(cmd): improve command descriptions

starport/cmd/chain.go

@@ -7,7 +7,8 @@ import "github.com/spf13/cobra"
 func NewChain() *cobra.Command {
 	c := &cobra.Command{
 		Use:     "chain [command]",
-		Short:   "Build, initialize, and start a blockchain in development",
+		Short:   "Build, initialize and start a blockchain node or perform other actions on the blockchain",
+		Long:    `Build, initialize and start a blockchain node or perform other actions on the blockchain.`,
 		Aliases: []string{"c"},
 		Args:    cobra.ExactArgs(1),
 	}

starport/cmd/cmd.go

@@ -30,8 +30,15 @@ func New() *cobra.Command {
 	cobra.EnableCommandSorting = false
 
 	c := &cobra.Command{
-		Use:           "starport",
-		Short:         "A developer tool for building Cosmos SDK blockchains",
+		Use:   "starport",
+		Short: "Starport offers everything you need to scaffold, test, build, and launch your blockchain",
+		Long: `Starport is a tool for creating sovereign blockchains built with Cosmos SDK, the world’s
+most popular modular blockchain framework. Starport offers everything you need to scaffold,
+test, build, and launch your blockchain.
+
+To get started, create a blockchain:
+
+starport scaffold chain github.com/cosmonaut/mars`,
 		SilenceUsage:  true,
 		SilenceErrors: true,
 		PersistentPreRunE: func(cmd *cobra.Command, args []string) error {

starport/cmd/scaffold.go

@@ -21,8 +21,11 @@ const (
 // NewScaffold returns a command that groups scaffolding related sub commands.
 func NewScaffold() *cobra.Command {
 	c := &cobra.Command{
-		Use:     "scaffold [command]",
-		Short:   "Scaffold a new blockchain, module, message, query, and more",
+		Use:   "scaffold [command]",
+		Short: "Scaffold a new blockchain, module, message, query, and more",
+		Long: `Scaffold commands create and modify the source code files to add functionality.
+
+CRUD stands for "create, read, update, delete".`,
 		Aliases: []string{"s"},
 		Args:    cobra.ExactArgs(1),
 	}