From 3589a7d56ef920cb3a00648f2ad9c27175f21baa Mon Sep 17 00:00:00 2001 From: cellarspoon Date: Mon, 20 Dec 2021 00:59:48 +0100 Subject: [PATCH] docs: explain tags --- cli/recipe/sync.go | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/cli/recipe/sync.go b/cli/recipe/sync.go index f2ff73ae..a1762a26 100644 --- a/cli/recipe/sync.go +++ b/cli/recipe/sync.go @@ -60,7 +60,20 @@ You may invoke this command in "wizard" mode and be prompted for input: nextTag := c.Args().Get(1) if len(tags) == 0 && nextTag == "" { - logrus.Warnf("no tags found for %s", recipe.Name) + logrus.Warnf("no git tags found for %s", recipe.Name) + fmt.Println(fmt.Sprintf(` +The following options are two types of initial version that you can pick for +the first published version of %s that will be in the recipe catalogue. This +follows the semver convention (more on semver.org), here is a short cheatsheet + + 0.1.0 -> development release, still hacking + 1.0.0 -> public release, assumed to be working + +In other words, if you want people to be able alpha test your current config +for %s but don't think it is quite ready and reliable, go with 0.1.0 and people +will know that things are likely to change. + +`, recipe.Name, recipe.Name)) var chosenVersion string edPrompt := &survey.Select{ Message: "which version do you want to begin with?",