PR feedback: adjust help message to better reflect command capabiliti…

…es and requirements

Signed-off-by: Piotr Zaniewski <piotr@upbound.io>

cmd/crank/beta/beta.go

@@ -31,7 +31,7 @@ type Cmd struct {
 	// Subcommands and flags will appear in the CLI help output in the same
 	// order they're specified here. Keep them in alphabetical order.
 	Render render.Cmd `cmd:"" help:"Render a composite resource (XR)."`
-	Top    top.Cmd    `cmd:"" help:"Top provides a dynamic real-time view of resources consumption by Crossplane pods."`
+	Top    top.Cmd    `cmd:"" help:"Display resource (CPU/memory) usage by Crossplane related pods."`
 	Trace  trace.Cmd  `cmd:"" help:"Trace a Crossplane resource to get a detailed output of its relationships, helpful for troubleshooting."`
 	XPKG   xpkg.Cmd   `cmd:"" help:"Manage Crossplane packages."`
 }

cmd/crank/beta/top/top.go

@@ -61,6 +61,8 @@ func (c *Cmd) Help() string {
 	return `
 This command returns current resources utilization (CPU and Memory) by Crossplane pods.
 
+Similar to kubectl top pods, it requires Metrics Server to be correctly configured and working on the server.
+
 Examples:
   # Show resources utilization for all Crossplane pods in the default 'crossplane-system' namespace in a tabular format.
   crossplane beta top
@@ -136,6 +138,7 @@ func (c *Cmd) Run(k *kong.Context, logger logging.Logger) error { //nolint:gocyc
 		return errors.Wrap(err, errFetchAllPods)
 	}
 
+	// TODO:(piotr1215) if there are no crossplane pods found we should pring message and exit gracefully
 	crossplanePods := getCrossplanePods(pods.Items)
 	logger.Debug("Fetched all pods from and filtered out Crossplane", "pods", crossplanePods, "namespace", c.Namespace)