docs: expand deploy/upgrade/downgrade docs

cli/app/deploy.go

@@ -26,7 +26,11 @@ var appDeployCommand = &cli.Command{
 	Description: `
 This command deploys a new instance of an app. It does not support changing the
 version of an existing deployed app, for this you need to look at the "abra app
-upgrade <app>" command. You may pass "--force" to re-deploy the same version.
+upgrade <app>" command.
+
+You may pass "--force" to re-deploy the same version again. This can be useful
+if the container runtime has gotten into a weird state or your doing some live
+hacking.
 `,
 	Action: func(c *cli.Context) error {
 		app := internal.ValidateApp(c)

cli/app/rollback.go

@@ -26,6 +26,13 @@ var appRollbackCommand = &cli.Command{
 	},
 	Description: `
 This command rolls an app back to a previous version if one exists.
+
+You may pass "--force/-f" to downgrade to the same version again. This can be
+useful if the container runtime has gotten into a weird state or your doing
+some live hacking.
+
+This action could be destructive, please ensure you have a copy of your app
+data beforehand - see "abra app backup <app>" for more.
 `,
 	BashComplete: func(c *cli.Context) {
 		appNames, err := config.GetAppNames()

cli/app/upgrade.go

@@ -25,10 +25,18 @@ var appUpgradeCommand = &cli.Command{
 	},
 	Description: `
 This command supports upgrading an app. You can use it to choose and roll out a
-new upgrade to an existing app. This command specifically supports changing the
+new upgrade to an existing app.
-version of running apps, as opposed to "abra app deploy <app>". This action
+
-could be destructive, please ensure you have a copy of your app data beforehand
+This command specifically supports changing the version of running apps, as
-- see "abra app backup <app>" for more.
+opposed to "abra app deploy <app>" which will not change the version of a
+deployed app.
+
+You may pass "--force/-f" to upgrade to the same version again. This can be
+useful if the container runtime has gotten into a weird state or your doing
+some live hacking.
+
+This action could be destructive, please ensure you have a copy of your app
+data beforehand - see "abra app backup <app>" for more.
 `,
 	Action: func(c *cli.Context) error {
 		app := internal.ValidateApp(c)