docs: update the release description

cli/recipe/release.go

@@ -27,11 +27,9 @@ var recipeReleaseCommand = &cli.Command{
 	Aliases:   []string{"rl"},
 	ArgsUsage: "<recipe> [<version>]",
 	Description: `
-This command is used to specify a new tag for a recipe. These tags are used to
+This command is used to specify a new version of a recipe. These versions are
-identify different versions of the recipe and are published on the Co-op Cloud
+then published on the Co-op Cloud recipe catalogue. These versions take the
-recipe catalogue.
+following form:
-
-These tags take the following form:
 
     a.b.c+x.y.z
 
@@ -40,16 +38,14 @@ the "x.y.z" part is the image tag of the recipe "app" service (the main
 container which contains the software to be used).
 
 We maintain a semantic versioning scheme ("a.b.c") alongside the libre app
-versioning scheme in order to maximise the chances that the nature of recipe
+versioning scheme ("x.y.z") in order to maximise the chances that the nature of
-updates are properly communicated.
+recipe updates are properly communicated. I.e. developers of an app might
+publish a minor version but that might lead to changes in the recipe which are
+major and therefore require intervention while doing the upgrade work.
 
-Abra does its best to read the "a.b.c" version scheme and communicate what
+Publish your new release to git.coopcloud.tech with "-p/--publish". This
-action needs to be taken when performing different operations such as an update
+requires that you have permission to git push to these repositories and have
-or a rollback of an app.
+your SSH keys configured on your account.
-
-Publish your new release git.coopcloud.tech with "-p/--publish". This requires
-that you have permission to git push to these repositories and have your SSH
-keys configured on your account.
 `,
 	Flags: []cli.Flag{
 		internal.DryFlag,