diff --git a/cli/updater/updater.go b/cli/updater/updater.go
index d49e5c8a..ba73b162 100644
--- a/cli/updater/updater.go
+++ b/cli/updater/updater.go
@@ -44,7 +44,7 @@ var Notify = cli.Command{
 		majorFlag,
 	},
 	Before:      internal.SubCommandBefore,
-	Description: `Check for available upgrades`,
+	Description: `It reads the deployed app versions and looks for new versions in the recipe catalogue. If a new patch/minor version is available, a notification is printed. To include major versions use the --major flag.`,
 	Action: func(c *cli.Context) error {
 
 		cl, err := client.New("default")
@@ -80,7 +80,7 @@ var UpgradeApp = cli.Command{
 		majorFlag,
 	},
 	Before:      internal.SubCommandBefore,
-	Description: `Upgrade an app`,
+	Description: `Upgrade an app by specifying its stack name and recipe. By passing --all instead every deployed app is upgraded. For each apps with enabled auto updates the deployed version is compared with the current recipe catalogue version. If a new patch/minor version is available the app is upgraded. To include major versions use the --major flag. Don't do that, it will probably break things. Only apps that are not deployed with --chaos are upgraded, to update chaos deployments use the --chaos flag. Use it with care.`,
 	Action: func(c *cli.Context) error {
 		stackName := c.Args().Get(0)
 		recipeName := c.Args().Get(1)