Better help texts

internal/cmd/config/add.go

@@ -16,6 +16,7 @@ func NewAddCommand(s state.State) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:                   "add <key> <value>...",
 		Short:                 "Add values to a list",
+		Long:                  "Add values to a list. For a list of all available configuration options, run 'hcloud help config'.",
 		Args:                  util.Validate,
 		TraverseChildren:      true,
 		DisableFlagsInUseLine: true,

internal/cmd/config/config.go

@@ -20,10 +20,17 @@ func NewCommand(s state.State) *cobra.Command {
 		Use:   "config",
 		Short: "Manage configuration",
 		Long: `This command allows you to manage options for the Hetzner Cloud CLI. Options can be set inside the
-configuration file, through environment variables or with flags. Most options are 'preferences' -
-these options can be set globally and can additionally be overridden for each context. 
+configuration file, through environment variables or with flags. 
 
-Below is a list of all non-preference options:
+The hierarchy for configuration sources is as follows (from highest to lowest priority):
+1. Flags
+2. Environment variables
+3. Configuration file (context)
+4. Configuration file (global)
+5. Default values
+
+Most options are 'preferences' - these options can be set globally and can additionally be overridden
+for each context. Below is a list of all non-preference options:
 
 ` + nonPreferenceOptions +
 			`

internal/cmd/config/get.go

@@ -14,6 +14,7 @@ func NewGetCommand(s state.State) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:                   "get <key>",
 		Short:                 "Get a configuration value",
+		Long:                  "Get a configuration value. For a list of all available configuration options, run 'hcloud help config'.",
 		Args:                  util.Validate,
 		TraverseChildren:      true,
 		DisableFlagsInUseLine: true,

internal/cmd/config/remove.go

@@ -16,6 +16,7 @@ func NewRemoveCommand(s state.State) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:                   "remove <key> <value>...",
 		Short:                 "Remove values from a list",
+		Long:                  "Remove values from a list. For a list of all available configuration options, run 'hcloud help config'.",
 		Args:                  util.Validate,
 		TraverseChildren:      true,
 		DisableFlagsInUseLine: true,

internal/cmd/config/set.go

@@ -15,6 +15,7 @@ func NewSetCommand(s state.State) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:                   "set <key> <value>...",
 		Short:                 "Set a configuration value",
+		Long:                  "Set a configuration value. For a list of all available configuration options, run 'hcloud help config'.",
 		Args:                  util.Validate,
 		TraverseChildren:      true,
 		DisableFlagsInUseLine: true,

internal/cmd/config/unset.go

@@ -16,6 +16,7 @@ func NewUnsetCommand(s state.State) *cobra.Command {
 	cmd := &cobra.Command{
 		Use:                   "unset <key>",
 		Short:                 "Unset a configuration value",
+		Long:                  "Unset a configuration value. For a list of all available configuration options, run 'hcloud help config'.",
 		Args:                  util.Validate,
 		TraverseChildren:      true,
 		DisableFlagsInUseLine: true,