Merge pull request #48289 from bergerhoffer/pr-47715

Expanded the oc completion page to include the setup steps for both B…

Author: bergerhoffer

cli_reference/openshift_cli/configuring-cli.adoc

@@ -6,5 +6,13 @@ include::_attributes/common-attributes.adoc[]
 
 toc::[]
 
-// Enabling tab completion
-include::modules/cli-configuring-completion.adoc[leveloffset=+1]
+[id="cli-enabling-tab-completion"]
+== Enabling tab completion
+
+You can enable tab completion for the Bash or Zsh shells.
+
+// Enabling tab completion for Bash
+include::modules/cli-configuring-completion.adoc[leveloffset=+2]
+
+// Enabling tab completion for Zsh
+include::modules/cli-configuring-completion-zsh.adoc[leveloffset=+2]

modules/cli-configuring-completion-zsh.adoc

@@ -0,0 +1,29 @@
+// Module included in the following assemblies:
+//
+// * cli_reference/openshift_cli/configuring-cli.adoc
+
+:_content-type: PROCEDURE
+[id="cli-enabling-tab-completion-zsh_{context}"]
+= Enabling tab completion for Zsh
+
+After you install the OpenShift CLI (`oc`), you can enable tab completion to automatically complete `oc` commands or suggest options when you press Tab. The following procedure enables tab completion for the Zsh shell.
+
+.Prerequisites
+
+* You must have the OpenShift CLI (`oc`) installed.
+
+.Procedure
+
+* To add tab completion for `oc` to your `.zshrc` file, run the following command:
++
+[source,terminal]
+----
+$ cat >>~/.zshrc<<EOF
+if [ $commands[oc] ]; then
+  source <(oc completion zsh)
+  compdef _oc oc
+fi
+EOF
+----
+
+Tab completion is enabled when you open a new terminal.

modules/cli-configuring-completion.adoc

@@ -4,35 +4,31 @@
 
 :_content-type: PROCEDURE
 [id="cli-enabling-tab-completion_{context}"]
-= Enabling tab completion
+= Enabling tab completion for Bash
 
-After you install the `oc` CLI tool, you can enable tab completion to
-automatically complete `oc` commands or suggest options when you press Tab.
+After you install the OpenShift CLI (`oc`), you can enable tab completion to automatically complete `oc` commands or suggest options when you press Tab. The following procedure enables tab completion for the Bash shell.
 
 .Prerequisites
 
-* You must have the `oc` CLI tool installed.
+* You must have the OpenShift CLI (`oc`) installed.
 * You must have the package `bash-completion` installed.
 
 .Procedure
 
-The following procedure enables tab completion for Bash.
-
-. Save the Bash completion code to a file.
+. Save the Bash completion code to a file:
 +
 [source,terminal]
 ----
 $ oc completion bash > oc_bash_completion
 ----
 
-. Copy the file to `/etc/bash_completion.d/`.
+. Copy the file to `/etc/bash_completion.d/`:
 +
 [source,terminal]
 ----
 $ sudo cp oc_bash_completion /etc/bash_completion.d/
 ----
 +
-You can also save the file to a local directory and source it from your
-`.bashrc` file instead.
+You can also save the file to a local directory and source it from your `.bashrc` file instead.
 
 Tab completion is enabled when you open a new terminal.