diff --git a/bin/shep_env b/bin/shep_env
index 92225fa..825d2d7 100755
--- a/bin/shep_env
+++ b/bin/shep_env
@@ -5,6 +5,17 @@ export PS4=$'+ \e[0;40;36m${BASH_SOURCE}:${FUNCNAME[0]:+${FUNCNAME[0]}}:${LINENO
 ${DEBUG:+set -x}
 set -e
 
+#
+#    There is a shortcut to target specific environment in case you know what
+#    you need
+#
+#    ```
+#    SH_ID=205d4fca-66da-48c6-90ae-10a6f79610e3 SH_NS=aberezovsky shep_env
+#    ```
+#    By default scripts use tas-devex namespace, but you can easially point
+#    to your personal namespace
+#
+
 export SH_NS=${SH_NS:-tas-devex} \
        SH_ID=${SH_ID:---last-lease}
 
diff --git a/bin/shep_select b/bin/shep_select
index 272141c..d5c37b2 100755
--- a/bin/shep_select
+++ b/bin/shep_select
@@ -5,6 +5,21 @@ export PS4=$'+ \e[0;40;36m${BASH_SOURCE}:${FUNCNAME[0]:+${FUNCNAME[0]}}:${LINENO
 # env SHELLOPTS="${SHELLOPTS}:xtrace" shep_env
 set -e
 
+#
+#    By default scripts use tas-devex namespace, but you can easially point
+#    to your personal namespace
+#
+#    ```
+#    SH_NS=aberezovsky shep_env
+#    ```
+#
+#    You can pass environment filter options after `s` or `shep_select`
+#    command
+#    ```
+#    shep_select APPSMAN-148
+#    ```
+#
+
 ${DEBUG:+set -x}
 
 export SH_NS="${SH_NS:-tas-devex}"