docs: more CLI documentation

cli/recipe.go

@@ -169,6 +169,7 @@ func ReadAppsCatalogueWeb(target interface{}) error {
 
 var recipeListCommand = &cli.Command{
 	Name:    "list",
+	Usage:   "List all available recipes",
 	Aliases: []string{"ls"},
 	Action: func(c *cli.Context) error {
 		catalogue, err := ReadAppsCatalogue()
@@ -297,6 +298,16 @@ var recipeCreateCommand = &cli.Command{
 var RecipeCommand = &cli.Command{
 	Name:  "recipe",
 	Usage: "Manage app recipes",
+	Description: `
+A recipe is a blueprint for a Co-op Cloud app. It is made up of two things:
+
+- A libre software app (e.g. Nextcloud, Wordpress, Mastodon)
+- A package configuration which describes how to deploy and maintain it
+
+Recipes are developed, maintained and extended by the Co-op Cloud volunteer-run
+community. Each recipe has a "level" which is intended as a way to quickly show
+how reliable this app is to deploy and maintain in its current state.
+`,
 	Subcommands: []*cli.Command{
 		recipeListCommand,
 		recipeVersionCommand,