docs: short aliases, short descriptions [ci skip]

cli/app/app.go

@@ -8,6 +8,7 @@ import (
 var AppCommand = &cli.Command{
 	Name:      "app",
 	Usage:     "Manage apps",
+	Aliases:   []string{"a"},
 	ArgsUsage: "<app>",
 	Description: `
 This command provides all the functionality you need to manage the life cycle

cli/cli.go

@@ -39,7 +39,7 @@ var DebugFlag = &cli.BoolFlag{
 // RunApp runs CLI abra app.
 func RunApp(version, commit string) {
 	app := &cli.App{
-		Name: "abra",
+		Name: "Abra",
 		Usage: `The Co-op Cloud command-line utility belt 🎩🐇
 
     ____                           ____ _                 _

cli/recipe/recipe.go

@@ -29,7 +29,7 @@ import (
 
 var recipeListCommand = &cli.Command{
 	Name:    "list",
-	Usage:   "List all available recipes",
+	Usage:   "List available recipes",
 	Aliases: []string{"ls"},
 	Action: func(c *cli.Context) error {
 		catl, err := catalogue.ReadRecipeCatalogue()
@@ -52,7 +52,8 @@ var recipeListCommand = &cli.Command{
 
 var recipeVersionCommand = &cli.Command{
 	Name:      "versions",
-	Usage:     "List available versions for <recipe>",
+	Usage:     "List recipe versions",
+	Aliases:   []string{"v"},
 	ArgsUsage: "<recipe>",
 	Action: func(c *cli.Context) error {
 		recipe := c.Args().First()
@@ -88,6 +89,7 @@ var recipeVersionCommand = &cli.Command{
 var recipeCreateCommand = &cli.Command{
 	Name:      "create",
 	Usage:     "Create a new recipe",
+	Aliases:   []string{"c"},
 	ArgsUsage: "<recipe>",
 	Action: func(c *cli.Context) error {
 		recipe := c.Args().First()
@@ -156,6 +158,7 @@ var recipeCreateCommand = &cli.Command{
 var recipeUpgradeCommand = &cli.Command{
 	Name:    "upgrade",
 	Usage:   "Upgrade recipe image tags",
+	Aliases: []string{"u"},
 	Description: `
 This command reads and attempts to parse all image tags within the given
 <recipe> configuration and prompt with more recent tags to upgrade to. It will
@@ -287,7 +290,8 @@ This is step 1 of upgrading a recipe. Step 2 is running "abra recipe sync
 
 var recipeSyncCommand = &cli.Command{
 	Name:    "sync",
-	Usage: "Generate recipe labels",
+	Usage:   "Generate new recipe labels",
+	Aliases: []string{"s"},
 	Description: `
 This command will generate labels for each service which correspond to the
 following format:
@@ -355,7 +359,8 @@ the versioning metadata of up-and-running containers are.
 
 var recipeLintCommand = &cli.Command{
 	Name:      "lint",
-	Usage:     "Recipe configuration linter",
+	Usage:     "Lint a recipe",
+	Aliases:   []string{"l"},
 	ArgsUsage: "<recipe>",
 	Action: func(c *cli.Context) error {
 		recipe := c.Args().First()
@@ -449,9 +454,12 @@ var recipeLintCommand = &cli.Command{
 var RecipeCommand = &cli.Command{
 	Name:      "recipe",
 	Usage:     "Manage recipes",
+	ArgsUsage: "<recipe>",
+	Aliases:   []string{"r"},
 	Description: `
-A recipe is a blueprint for an app. It describes how to deploy and maintain an
+A recipe is a blueprint for an app. It is a bunch of configuration files which
-app.
+describe how to deploy and maintain an app. Recipes are maintained by the Co-op
+Cloud community and you can use Abra to read them and create apps for you.
 `,
 	Subcommands: []*cli.Command{
 		recipeListCommand,

cli/server/server.go

@@ -7,7 +7,8 @@ import (
 // ServerCommand defines the `abra server` command and its subcommands
 var ServerCommand = &cli.Command{
 	Name:      "server",
-	ArgsUsage: "<host>",
+	ArgsUsage: "<server>",
+	Aliases:   []string{"s"},
 	Usage:     "Manage servers",
 	Description: `
 Manage the lifecycle of a server.

cli/version.go

@@ -7,7 +7,7 @@ import (
 // VersionCommand prints the version of abra.
 var VersionCommand = &cli.Command{
 	Name:  "version",
-	Usage: "Print the version",
+	Usage: "Print version",
 	Action: func(c *cli.Context) error {
 		cli.VersionPrinter(c)
 		return nil