From 9d93573aac5068731945ebd34ad5fb7a99909b02 Mon Sep 17 00:00:00 2001
From: Kjeld Schouten <info@kjeldschouten.nl>
Date: Fri, 25 Oct 2024 18:29:29 +0200
Subject: [PATCH] docs(clustertool): add more in-code documentation

---
 clustertool/cmd/adv.go                 |  1 +
 clustertool/cmd/adv_bootstrap.go       |  9 +++++----
 clustertool/cmd/adv_health.go          |  7 ++++---
 clustertool/cmd/adv_precommit.go       |  7 ++++---
 clustertool/cmd/adv_reset.go           |  7 ++++---
 clustertool/cmd/adv_testcmd.go         |  4 ++--
 clustertool/cmd/apply.go               |  7 ++++---
 clustertool/cmd/charts.go              |  9 ++++-----
 clustertool/cmd/charts_bump.go         |  2 +-
 clustertool/cmd/charts_deps.go         |  2 +-
 clustertool/cmd/charts_genchangelog.go |  2 +-
 clustertool/cmd/charts_genchartlist.go |  2 +-
 clustertool/cmd/charts_genmeta.go      |  7 ++++---
 clustertool/cmd/charts_tagclean.go     |  2 +-
 clustertool/cmd/checkcrypt.go          |  7 ++++---
 clustertool/cmd/decrypt.go             |  7 ++++---
 clustertool/cmd/encrypt.go             |  7 ++++---
 clustertool/cmd/fluxbootstrap.go       |  7 ++++---
 clustertool/cmd/helmrelease.go         |  5 +++--
 clustertool/cmd/helmrelease_install.go |  7 ++++---
 clustertool/cmd/helmrelease_upgrade.go |  7 ++++---
 clustertool/cmd/info.go                |  9 +++++++++
 clustertool/cmd/init.go                |  1 -
 clustertool/cmd/root.go                | 18 +-----------------
 clustertool/cmd/scale.go               |  5 ++++-
 clustertool/cmd/scale_export.go        |  7 ++++---
 clustertool/cmd/scale_migrate.go       |  7 ++++---
 clustertool/cmd/upgrade.go             |  7 ++++---
 28 files changed, 90 insertions(+), 79 deletions(-)

diff --git a/clustertool/cmd/adv.go b/clustertool/cmd/adv.go
index 673f6c635c53..18bacb9eb565 100644
--- a/clustertool/cmd/adv.go
+++ b/clustertool/cmd/adv.go
@@ -14,6 +14,7 @@ These are all advanced commands that should generally not be needed
 var adv = &cobra.Command{
     Use:           "adv",
     Short:         "Advanced cluster maintanence commands",
+    Example:       "clustertool adv <bootstrap/health/precommit>",
     Long:          advLongHelp,
     SilenceUsage:  true,
     SilenceErrors: true,
diff --git a/clustertool/cmd/adv_bootstrap.go b/clustertool/cmd/adv_bootstrap.go
index fed6f97776e4..54dfc5821474 100644
--- a/clustertool/cmd/adv_bootstrap.go
+++ b/clustertool/cmd/adv_bootstrap.go
@@ -12,10 +12,11 @@ var advBootstrapLongHelp = strings.TrimSpace(`
 `)
 
 var bootstrap = &cobra.Command{
-    Use:   "bootstrap",
-    Short: "bootstrap first Talos Node",
-    Long:  advBootstrapLongHelp,
-    Run:   bootstrapfunc,
+    Use:     "bootstrap",
+    Short:   "bootstrap first Talos Node",
+    Example: "clustertool adv bootstrap",
+    Long:    advBootstrapLongHelp,
+    Run:     bootstrapfunc,
 }
 
 func bootstrapfunc(cmd *cobra.Command, args []string) {
diff --git a/clustertool/cmd/adv_health.go b/clustertool/cmd/adv_health.go
index d5e33d9af884..2a2cf558e0bc 100644
--- a/clustertool/cmd/adv_health.go
+++ b/clustertool/cmd/adv_health.go
@@ -15,9 +15,10 @@ var advHealthLongHelp = strings.TrimSpace(`
 `)
 
 var health = &cobra.Command{
-    Use:   "health",
-    Short: "Check Talos Cluster Health",
-    Long:  advHealthLongHelp,
+    Use:     "health",
+    Short:   "Check Talos Cluster Health",
+    Example: "clustertool adv health",
+    Long:    advHealthLongHelp,
     Run: func(cmd *cobra.Command, args []string) {
         if err := sops.DecryptFiles(); err != nil {
             log.Info().Msgf("Error decrypting files: %v\n", err)
diff --git a/clustertool/cmd/adv_precommit.go b/clustertool/cmd/adv_precommit.go
index 59dd3834a561..db11a1bff15f 100644
--- a/clustertool/cmd/adv_precommit.go
+++ b/clustertool/cmd/adv_precommit.go
@@ -14,9 +14,10 @@ var advPrecommitLongHelp = strings.TrimSpace(`
 `)
 
 var precommit = &cobra.Command{
-    Use:   "precommit",
-    Short: "Runs the PreCommit encryption check",
-    Long:  advPrecommitLongHelp,
+    Use:     "precommit",
+    Short:   "Runs the PreCommit encryption check",
+    Example: "clustertool adv precommit",
+    Long:    advPrecommitLongHelp,
     Run: func(cmd *cobra.Command, args []string) {
         if err := sops.CheckFilesAndReportEncryption(true, true); err != nil {
             log.Info().Msgf("Error checking files: %v\n", err)
diff --git a/clustertool/cmd/adv_reset.go b/clustertool/cmd/adv_reset.go
index 8e3ab4b39f9d..12806a29af13 100644
--- a/clustertool/cmd/adv_reset.go
+++ b/clustertool/cmd/adv_reset.go
@@ -14,9 +14,10 @@ var advResetLongHelp = strings.TrimSpace(`
 `)
 
 var reset = &cobra.Command{
-    Use:   "reset",
-    Short: "Reset Talos Nodes and Kubernetes",
-    Long:  advResetLongHelp,
+    Use:     "reset",
+    Short:   "Reset Talos Nodes and Kubernetes",
+    Example: "clustertool adv reset <NodeIP>",
+    Long:    advResetLongHelp,
     Run: func(cmd *cobra.Command, args []string) {
         var extraArgs []string
         node := ""
diff --git a/clustertool/cmd/adv_testcmd.go b/clustertool/cmd/adv_testcmd.go
index f9ca2ead05b8..aace297a4f46 100644
--- a/clustertool/cmd/adv_testcmd.go
+++ b/clustertool/cmd/adv_testcmd.go
@@ -10,12 +10,12 @@ import (
 )
 
 var advTestCmdlongHelp = strings.TrimSpace(`
-
+This command is mostly just for development usage and should NEVER be used by end-users.
 `)
 
 var testcmd = &cobra.Command{
     Use:   "test",
-    Short: "test run",
+    Short: "tests specific code for developer usages",
     Long:  advTestCmdlongHelp,
     Run: func(cmd *cobra.Command, args []string) {
         initfiles.LoadTalEnv(false)
diff --git a/clustertool/cmd/apply.go b/clustertool/cmd/apply.go
index 936eecc57f88..26e36669a743 100644
--- a/clustertool/cmd/apply.go
+++ b/clustertool/cmd/apply.go
@@ -16,9 +16,10 @@ var applyLongHelp = strings.TrimSpace(`
 `)
 
 var apply = &cobra.Command{
-    Use:   "apply",
-    Short: "apply TalosConfig",
-    Long:  applyLongHelp,
+    Use:     "apply",
+    Short:   "apply TalosConfig",
+    Example: "clustertool apply <NodeIP>",
+    Long:    applyLongHelp,
     Run: func(cmd *cobra.Command, args []string) {
         var extraArgs []string
         node := ""
diff --git a/clustertool/cmd/charts.go b/clustertool/cmd/charts.go
index 4175c6e10751..11573575ceea 100644
--- a/clustertool/cmd/charts.go
+++ b/clustertool/cmd/charts.go
@@ -7,12 +7,10 @@ import (
 )
 
 var chartsLongHelp = strings.TrimSpace(`
-charttool is a tool to help you build TrueCharts Charts
+charttool was a tool to help you build TrueCharts Charts.
+It has since been merged into Clustertool as "clustertool charts"
 
-Workflow:
-  Create talconfig.yaml file defining your nodes information like so:
-
- Available commands
+ Example commands
   > charttool bump 1.2.3 patch
   > charttool tagclean soemtag@somedigest
 
@@ -21,6 +19,7 @@ Workflow:
 var charts = &cobra.Command{
     Use:           "charts",
     Short:         "A tool to help with creating Talos cluster",
+    Example:       "charttool bump 1.2.3 patch",
     Long:          chartsLongHelp,
     SilenceUsage:  true,
     SilenceErrors: true,
diff --git a/clustertool/cmd/charts_bump.go b/clustertool/cmd/charts_bump.go
index 347f377a0db2..f3310b979183 100644
--- a/clustertool/cmd/charts_bump.go
+++ b/clustertool/cmd/charts_bump.go
@@ -16,7 +16,7 @@ var bumper = &cobra.Command{
     Use:     "bump",
     Short:   "generate a bumped image version",
     Long:    chartsBumpLongHelp,
-    Example: "charttool bump <version> <kind>",
+    Example: "clustertool charts bump <version> <kind>",
     Args:    cobra.ExactArgs(2),
     Run: func(cmd *cobra.Command, args []string) {
         if err := version.Bump(args[0], args[1]); err != nil {
diff --git a/clustertool/cmd/charts_deps.go b/clustertool/cmd/charts_deps.go
index 892d9648631c..ac0df3be5a0c 100644
--- a/clustertool/cmd/charts_deps.go
+++ b/clustertool/cmd/charts_deps.go
@@ -17,7 +17,7 @@ var depsCmd = &cobra.Command{
     Use:     "deps",
     Short:   "Download, Update and Verify Helm dependencies",
     Long:    chartsDepsLongHelp,
-    Example: "charttool deps <chart> <chart> <chart>",
+    Example: "clustertool charts deps <chart> <chart> <chart>",
     Run: func(cmd *cobra.Command, args []string) {
         if err := deps.LoadGPGKey(); err != nil {
             log.Fatal().Err(err).Msg("failed to load gpg key")
diff --git a/clustertool/cmd/charts_genchangelog.go b/clustertool/cmd/charts_genchangelog.go
index 51188db80796..d76badce4f18 100644
--- a/clustertool/cmd/charts_genchangelog.go
+++ b/clustertool/cmd/charts_genchangelog.go
@@ -17,7 +17,7 @@ var genChangelogCmd = &cobra.Command{
     Use:     "genchangelog",
     Short:   "Generate changelog for charts",
     Long:    chartsGenChangelogLongHelp,
-    Example: "charttool genchangelog <repo path> <template path> <charts dir>",
+    Example: "clustertool charts genchangelog <repo path> <template path> <charts dir>",
     Run: func(cmd *cobra.Command, args []string) {
         if len(args) < 3 {
             log.Fatal().Msg("Missing required arguments. Please provide the repo path, template path and charts directory.")
diff --git a/clustertool/cmd/charts_genchartlist.go b/clustertool/cmd/charts_genchartlist.go
index a68b136b791e..4f13bd57ac7f 100644
--- a/clustertool/cmd/charts_genchartlist.go
+++ b/clustertool/cmd/charts_genchartlist.go
@@ -18,7 +18,7 @@ var genChartListCmd = &cobra.Command{
     Use:     "genchartlist",
     Short:   "Generate chart list json file",
     Long:    chartsGenChartsListLongHelp,
-    Example: "charttool genchartlist <path to charts folder>",
+    Example: "clustertool charts genchartlist <path to charts folder>",
     Run: func(cmd *cobra.Command, args []string) {
         opts := &website.ChartListOptions{
             OutputPath:  "./charts.json",
diff --git a/clustertool/cmd/charts_genmeta.go b/clustertool/cmd/charts_genmeta.go
index 0d8878ec12de..1c41e346c410 100644
--- a/clustertool/cmd/charts_genmeta.go
+++ b/clustertool/cmd/charts_genmeta.go
@@ -17,9 +17,10 @@ var chartsGenMetaLongHelp = strings.TrimSpace(`
 `)
 
 var genMetaCmd = &cobra.Command{
-    Use:   "genmeta",
-    Short: "Generate and update Chart.yaml metadata",
-    Long:  chartsGenMetaLongHelp,
+    Use:     "genmeta",
+    Short:   "Generate and update Chart.yaml metadata",
+    Example: "clustertool charts genmeta",
+    Long:    chartsGenMetaLongHelp,
     Run: func(cmd *cobra.Command, args []string) {
         bump := ""
         if len(args) > 0 && slices.Contains([]string{"patch", "minor", "major"}, args[0]) {
diff --git a/clustertool/cmd/charts_tagclean.go b/clustertool/cmd/charts_tagclean.go
index 524b912f938c..a59772eaf423 100644
--- a/clustertool/cmd/charts_tagclean.go
+++ b/clustertool/cmd/charts_tagclean.go
@@ -17,7 +17,7 @@ var tagCleaner = &cobra.Command{
     Use:     "tagcleaner",
     Short:   "Creates a clean version tag from a container digest",
     Long:    chartsTagCleanLongHelp,
-    Example: "charttool tagcleaner <tag>",
+    Example: "clustertool charts tagclean <tag>",
     Args:    cobra.ExactArgs(1),
     Run: func(cmd *cobra.Command, args []string) {
         err := image.Clean(args[0])
diff --git a/clustertool/cmd/checkcrypt.go b/clustertool/cmd/checkcrypt.go
index 56fee92a88bf..127e432d854f 100644
--- a/clustertool/cmd/checkcrypt.go
+++ b/clustertool/cmd/checkcrypt.go
@@ -14,9 +14,10 @@ var checkcyptLongHelp = strings.TrimSpace(`
 `)
 
 var checkcrypt = &cobra.Command{
-    Use:   "checkcrypt",
-    Short: "Checks if all files are encrypted correctly in accordance with .sops.yaml",
-    Long:  checkcyptLongHelp,
+    Use:     "checkcrypt",
+    Short:   "Checks if all files are encrypted correctly in accordance with .sops.yaml",
+    Example: "clustertool checkcrypt",
+    Long:    checkcyptLongHelp,
     Run: func(cmd *cobra.Command, args []string) {
         if err := sops.CheckFilesAndReportEncryption(false, false); err != nil {
             log.Info().Msgf("Error checking files: %v\n", err)
diff --git a/clustertool/cmd/decrypt.go b/clustertool/cmd/decrypt.go
index ddbcfe66275c..bacfe170e9b2 100644
--- a/clustertool/cmd/decrypt.go
+++ b/clustertool/cmd/decrypt.go
@@ -13,9 +13,10 @@ var decryptLongHelp = strings.TrimSpace(`
 `)
 
 var decrypt = &cobra.Command{
-    Use:   "decrypt",
-    Short: "Decrypt all high-risk data using sops",
-    Long:  decryptLongHelp,
+    Use:     "decrypt",
+    Short:   "Decrypt all high-risk data using sops",
+    Example: "clustertool decrypt",
+    Long:    decryptLongHelp,
     Run: func(cmd *cobra.Command, args []string) {
         if err := sops.DecryptFiles(); err != nil {
             log.Info().Msgf("Error decrypting files: %v\n", err)
diff --git a/clustertool/cmd/encrypt.go b/clustertool/cmd/encrypt.go
index 872aa3b2ae08..851cbe7de5b8 100644
--- a/clustertool/cmd/encrypt.go
+++ b/clustertool/cmd/encrypt.go
@@ -13,9 +13,10 @@ var encryptLongHelp = strings.TrimSpace(`
 `)
 
 var encrypt = &cobra.Command{
-    Use:   "encrypt",
-    Short: "Encrypt all high-risk data using sops",
-    Long:  encryptLongHelp,
+    Use:     "encrypt",
+    Short:   "Encrypt all high-risk data using sops",
+    Example: "clustertool encrypt",
+    Long:    encryptLongHelp,
     Run: func(cmd *cobra.Command, args []string) {
         if err := sops.EncryptAllFiles(); err != nil {
             log.Info().Msgf("Error encrypting files: %v\n", err)
diff --git a/clustertool/cmd/fluxbootstrap.go b/clustertool/cmd/fluxbootstrap.go
index 3b8859404504..7dcc54aae9a6 100644
--- a/clustertool/cmd/fluxbootstrap.go
+++ b/clustertool/cmd/fluxbootstrap.go
@@ -18,9 +18,10 @@ var fluxBootstrapLongHelp = strings.TrimSpace(`
 `)
 
 var fluxbootstrap = &cobra.Command{
-    Use:   "fluxbootstrap",
-    Short: "Manually bootstrap fluxcd on existing cluster",
-    Long:  fluxBootstrapLongHelp,
+    Use:     "fluxbootstrap",
+    Short:   "Manually bootstrap fluxcd on existing cluster",
+    Example: "clustertool fluxbootstrap",
+    Long:    fluxBootstrapLongHelp,
     Run: func(cmd *cobra.Command, args []string) {
         ctx := context.Background()
 
diff --git a/clustertool/cmd/helmrelease.go b/clustertool/cmd/helmrelease.go
index 7f18d061767f..6d60dabf2255 100644
--- a/clustertool/cmd/helmrelease.go
+++ b/clustertool/cmd/helmrelease.go
@@ -7,13 +7,14 @@ import (
 )
 
 var helmreleaseHelp = strings.TrimSpace(`
-A toolkit to load helm-release files onto a cluster without flux
-
+A toolkit to load helm-release files onto a cluster without flux.
+originally created to make it easier to install/upgrade/edit flux-based clusterresources without flux
 `)
 
 var helmrelease = &cobra.Command{
     Use:           "helmrelease",
     Short:         "A toolkit to load helm-release files onto a cluster without flux",
+    Example:       "clustertool helmrelease <install/upgrade>",
     Long:          advLongHelp,
     SilenceUsage:  true,
     SilenceErrors: true,
diff --git a/clustertool/cmd/helmrelease_install.go b/clustertool/cmd/helmrelease_install.go
index f59d78c6f312..9892b34c4e82 100644
--- a/clustertool/cmd/helmrelease_install.go
+++ b/clustertool/cmd/helmrelease_install.go
@@ -14,9 +14,10 @@ var hrInstalLongHelp = strings.TrimSpace(`
 `)
 
 var hrinstall = &cobra.Command{
-    Use:   "install",
-    Short: "install a helm-release file without flux, helm-release file needs to be called helm-release.yaml",
-    Long:  hrInstalLongHelp,
+    Use:     "install",
+    Short:   "install a helm-release file without flux, helm-release file needs to be called helm-release.yaml",
+    Example: "clustertool helmrelease install",
+    Long:    hrInstalLongHelp,
     Run: func(cmd *cobra.Command, args []string) {
         initfiles.LoadTalEnv(false)
 
diff --git a/clustertool/cmd/helmrelease_upgrade.go b/clustertool/cmd/helmrelease_upgrade.go
index 0e4e174d43ce..c5248852e576 100644
--- a/clustertool/cmd/helmrelease_upgrade.go
+++ b/clustertool/cmd/helmrelease_upgrade.go
@@ -14,9 +14,10 @@ var hrUpgradeLongHelp = strings.TrimSpace(`
 `)
 
 var hrupgrade = &cobra.Command{
-    Use:   "upgrade",
-    Short: "run helm-upgrade using a helm-release file without flux",
-    Long:  hrUpgradeLongHelp,
+    Use:     "upgrade",
+    Short:   "run helm-upgrade using a helm-release file without flux",
+    Example: "clustertool helmrelease upgrade",
+    Long:    hrUpgradeLongHelp,
     Run: func(cmd *cobra.Command, args []string) {
         initfiles.LoadTalEnv(false)
 
diff --git a/clustertool/cmd/info.go b/clustertool/cmd/info.go
index 20675f29307a..85d9b7e66f8f 100644
--- a/clustertool/cmd/info.go
+++ b/clustertool/cmd/info.go
@@ -8,6 +8,15 @@ import (
 )
 
 var infoLongHelp = strings.TrimSpace(`
+clustertool is a tool to help you easily deploy and maintain a Talos Kubernetes Cluster.
+
+
+Workflow:
+  Create talconfig.yaml file defining your nodes information like so:
+
+ Available commands
+  > clustertool init
+  > clustertool genconfig
 
 `)
 
diff --git a/clustertool/cmd/init.go b/clustertool/cmd/init.go
index 254c6b2f7e9a..965197b45f5e 100644
--- a/clustertool/cmd/init.go
+++ b/clustertool/cmd/init.go
@@ -16,7 +16,6 @@ Afterwards you can edit talconfig.yaml and clusterenv.yaml to reflect your perso
 
 When done, please run clustertool genconfig to generate all configarion based on your personal settings
 
-Powered by TalHelper (https://budimanjojo.github.io/talhelper/)
 
 `)
 
diff --git a/clustertool/cmd/root.go b/clustertool/cmd/root.go
index 01e521a74358..cc2fd1f3877f 100644
--- a/clustertool/cmd/root.go
+++ b/clustertool/cmd/root.go
@@ -3,7 +3,6 @@ package cmd
 import (
     "os"
     "path/filepath"
-    "strings"
 
     "github.com/rs/zerolog/log"
     "github.com/spf13/cobra"
@@ -12,25 +11,10 @@ import (
 
 var thisversion string
 
-var rootLongHelp = strings.TrimSpace(`
-clustertool is a tool to help you easily deploy and maintain a Talos Kubernetes Cluster.
-
-
-Workflow:
-  Create talconfig.yaml file defining your nodes information like so:
-
- Available commands
-  > clustertool init
-  > clustertool genconfig
-
-  Powered by TalHelper (https://budimanjojo.github.io/talhelper/)
-
-`)
-
 var RootCmd = &cobra.Command{
     Use:           "clustertool",
     Short:         "A tool to help with creating Talos cluster",
-    Long:          rootLongHelp,
+    Long:          infoLongHelp,
     SilenceUsage:  true,
     SilenceErrors: true,
     Version:       thisversion,
diff --git a/clustertool/cmd/scale.go b/clustertool/cmd/scale.go
index 5bca978adcb3..aee83f48173b 100644
--- a/clustertool/cmd/scale.go
+++ b/clustertool/cmd/scale.go
@@ -7,13 +7,16 @@ import (
 )
 
 var scaleLongHelp = strings.TrimSpace(`
-These are all advanced commands that should generally not be needed
+These are all commands that are exclusively intended to migrate away from TrueNAS SCALE Kubernetes Apps to a normal kubernets cluster.
+
+They will all, at a later date, be removed.
 
 `)
 
 var scaleCmd = &cobra.Command{
     Use:           "scale",
     Short:         "Commands for handling TrueNAS SCALE",
+    Example:       "clustertool scale export",
     Long:          advLongHelp,
     SilenceUsage:  true,
     SilenceErrors: true,
diff --git a/clustertool/cmd/scale_export.go b/clustertool/cmd/scale_export.go
index 1eb5d271adf1..35eaabffbc1d 100644
--- a/clustertool/cmd/scale_export.go
+++ b/clustertool/cmd/scale_export.go
@@ -12,9 +12,10 @@ var scaleExportLongHelp = strings.TrimSpace(`
 `)
 
 var scaleexport = &cobra.Command{
-    Use:   "export",
-    Short: "Export SCALE Apps to file",
-    Long:  scaleExportLongHelp,
+    Use:     "export",
+    Short:   "Export SCALE Apps to file",
+    Example: "clustertool scale export",
+    Long:    scaleExportLongHelp,
     Run: func(cmd *cobra.Command, args []string) {
         scale.ExportApps()
     },
diff --git a/clustertool/cmd/scale_migrate.go b/clustertool/cmd/scale_migrate.go
index abe54fbe555b..dd6c1214b4a9 100644
--- a/clustertool/cmd/scale_migrate.go
+++ b/clustertool/cmd/scale_migrate.go
@@ -13,9 +13,10 @@ var scaleMigrateLongHelp = strings.TrimSpace(`
 `)
 
 var scalemigrate = &cobra.Command{
-    Use:   "migrate",
-    Short: "Migrate exported SCALE Apps to the Talos Cluster",
-    Long:  scaleMigrateLongHelp,
+    Use:     "migrate",
+    Short:   "Migrate exported SCALE Apps to the Talos Cluster",
+    Example: "clustertool scale migrate",
+    Long:    scaleMigrateLongHelp,
     Run: func(cmd *cobra.Command, args []string) {
         err := scale.ProcessJSONFiles("./truenas_exports")
         if err != nil {
diff --git a/clustertool/cmd/upgrade.go b/clustertool/cmd/upgrade.go
index 9201d75b464a..8c543e30bff2 100644
--- a/clustertool/cmd/upgrade.go
+++ b/clustertool/cmd/upgrade.go
@@ -15,9 +15,10 @@ var upgradeLongHelp = strings.TrimSpace(`
 `)
 
 var upgrade = &cobra.Command{
-    Use:   "upgrade",
-    Short: "Upgrade Talos Nodes and Kubernetes",
-    Long:  upgradeLongHelp,
+    Use:     "upgrade",
+    Short:   "Upgrade Talos Nodes and Kubernetes",
+    Example: "clustertool upgrade <NodeIP>",
+    Long:    upgradeLongHelp,
     Run: func(cmd *cobra.Command, args []string) {
         var extraArgs []string
         node := ""