From 3e3ba9946ec3a80596428af1863094049d7fd2cc Mon Sep 17 00:00:00 2001
From: Ahmet Alp Balkan <ahmet@linkedin.com>
Date: Sun, 8 Mar 2026 13:15:07 -0700
Subject: [PATCH] docs: add description and legacy note to bash --help output

Add a one-line description and a note encouraging users to upgrade
to the Go-based implementation in the bash help messages.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 kubectx | 4 ++++
 kubens  | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/kubectx b/kubectx
index 4f02e5b..f00bbf3 100755
--- a/kubectx
+++ b/kubectx
@@ -33,6 +33,8 @@ usage() {
   fi
 
   cat <<EOF
+Manage and switch between kubectl contexts.
+
 USAGE:
   $SELF                       : list the contexts
   $SELF <NAME>                : switch to context <NAME>
@@ -46,6 +48,8 @@ USAGE:
   $SELF -u, --unset           : unset the current context
 
   $SELF -h,--help             : show this message
+
+  (This executable is the legacy bash-based implementation, consider upgrading to Go-based implementation.)
 EOF
 }
 
diff --git a/kubens b/kubens
index 8d5df32..1088915 100755
--- a/kubens
+++ b/kubens
@@ -33,12 +33,16 @@ usage() {
   fi
 
   cat <<EOF
+Switch between Kubernetes namespaces.
+
 USAGE:
   $SELF                    : list the namespaces in the current context
   $SELF <NAME>             : change the active namespace of current context
   $SELF -                  : switch to the previous namespace in this context
   $SELF -c, --current      : show the current namespace
   $SELF -h,--help          : show this message
+
+  (This executable is the legacy bash-based implementation, consider upgrading to Go-based implementation.)
 EOF
 }