From 87ebcd8f9884bfe15a996767ef1636787773a8b7 Mon Sep 17 00:00:00 2001
From: Ggg6542 <465806+gusega@users.noreply.github.com>
Date: Thu, 9 Feb 2023 03:11:53 +0100
Subject: [PATCH] Update shell_completions.md (#1907)

align documentation with the code : completions.go:452
---
 shell_completions.md | 11 +----------
 1 file changed, 1 insertion(+), 10 deletions(-)

diff --git a/shell_completions.md b/shell_completions.md
index f3285e310..6c48f3e4a 100644
--- a/shell_completions.md
+++ b/shell_completions.md
@@ -162,16 +162,7 @@ cmd := &cobra.Command{
 }
 ```
 
-The aliases are not shown to the user on tab completion, but they are accepted as valid nouns by
-the completion algorithm if entered manually, e.g. in:
-
-```bash
-$ kubectl get rc [tab][tab]
-backend        frontend       database
-```
-
-Note that without declaring `rc` as an alias, the completion algorithm would not know to show the list of
-replication controllers following `rc`.
+The aliases are shown to the user on tab completion only if no completions were found within sub-commands or `ValidArgs`.
 
 ### Dynamic completion of nouns