From 5c096bee21e46abde4a86fb6d7934c667560b310 Mon Sep 17 00:00:00 2001
From: abrennan <abrennan@redhat.com>
Date: Fri, 17 Jan 2020 11:51:36 -0600
Subject: [PATCH] Updates to Knative Client docs (Serverless)

---
 _topic_map.yml                                |   2 +-
 images/question-circle.png                    | Bin 0 -> 636 bytes
 modules/kubefed-document-attributes.adoc      |  25 -------------
 ...serverless-installing-cli-web-console.adoc |  35 ++++++++++++++++++
 serverless/knative-client.adoc                |  23 +++++++-----
 5 files changed, 49 insertions(+), 36 deletions(-)
 create mode 100644 images/question-circle.png
 delete mode 100644 modules/kubefed-document-attributes.adoc
 create mode 100644 modules/serverless-installing-cli-web-console.adoc

diff --git a/_topic_map.yml b/_topic_map.yml
index 36b574c89e..21e429fcd7 100644
--- a/_topic_map.yml
+++ b/_topic_map.yml
@@ -1445,7 +1445,7 @@ Topics:
 - Name: Configuring Knative Serving autoscaling
   File: configuring-knative-serving-autoscaling
 ### Using Knative Client
-- Name: Using Knative Client
+- Name: Getting started with Knative Client
   File: knative-client
 ### Release Notes
 - Name: Release Notes
diff --git a/images/question-circle.png b/images/question-circle.png
new file mode 100644
index 0000000000000000000000000000000000000000..a505ba1fcaddcce3e1a383564a0ea4868ea6b286
GIT binary patch
literal 636
zcmV-?0)zdDP)<h;3K|Lk000e1NJLTq000mG000jN1^@s6?Q>5r00006VoOIv0RI60
z0RN!9r;`8x010qNS#tmY3ljhU3ljkVnw%H_000McNliru<N*~B8X42Zj6wha0trb(
zK~yNub(76YRACgxfA76>bsX2`IOyn@Gd8W-ScW)b_JLI9E+}01!DK`QEh73CA`0n)
zAc$xeAq5!(kyEHS<tPP{;1oJ;galj9z4PkZqP*8Tb34m(p7Xr#d7g7bBpO$EgxuOf
zmL#CibsfVnykPjs6P9Js-X3G1zn^5H3&SwT<(7E<VuFRmMKn!w;l=JB2qAd<=mEV)
zdOTlSUti}~-)V})qMg%rH-DN=+s%c-8s`Ux=sn)Y#LHIzghC;{Eqq3nN)Brz8duGG
z+tuZ(*VIltdHPI+TVpER8dHreZK|bhpE`Qtq+L&c_^86IF%^l%l?I?`8u!NUIHWDj
zXu3`|GehocmfG4{mh*X5R#pM%NhT<jq%%T&{T|n>J;?;C`6cS=>X^%X!8A=Q%OVg6
z*qDJcryPPRqsmjXTet5rk{ZJ_O&;DKCm5`^YYoAmV`I@YJqf1LY4*qCyn8!|5W-bk
zEvz{<s%^#3<s7=MyFi7)8oxF+ICQY1g1n(ILQSCNpN#^BMp6}^109{5JvZp`9pLrk
z8>;=)js`*qX6G`@&u3l0)aWoxO^x{deml3h`J1szSL}@x<+pJ2#&uGo!=9Q<&&)D<
z;UZFQd9N~nl#);=MAzX?y1TpZ`F!NQFY$gVO+NplLMQRRYur`}DJ7`C*I3@T6Mq1?
W#l#S~@%x+r0000<MNUMnLSTYzNFoOS

literal 0
HcmV?d00001

diff --git a/modules/kubefed-document-attributes.adoc b/modules/kubefed-document-attributes.adoc
deleted file mode 100644
index 01feb68e43..0000000000
--- a/modules/kubefed-document-attributes.adoc
+++ /dev/null
@@ -1,25 +0,0 @@
-// Standard document attributes to be used in the documentation
-//
-// The following are shared by all documents:
-:toc:
-:toclevels: 4
-:experimental:
-//
-// Product content attributes, that is, substitution variables in the files.
-//
-:KubeFedProductName: OpenShift KubeFed
-:KubeFedProductShortName: KubeFed
-//
-// Documentation publishing attributes used in the master-docinfo.xml file
-// Note that the DocInfoProductName generates the URL for the product page.
-// Changing the value changes the generated URL.
-//
-:DocInfoProductName: OpenShift KubeFed
-//
-// Book Names:
-//     Defining the book names in document attributes instead of hard-coding them in
-//     the master.adoc files and in link references. This makes it easy to change the
-//     book name if necessary.
-//     Using the pattern ending in 'BookName' makes it easy to grep for occurrences
-//     throughout the topics
-//
diff --git a/modules/serverless-installing-cli-web-console.adoc b/modules/serverless-installing-cli-web-console.adoc
new file mode 100644
index 0000000000..82d6e6f2db
--- /dev/null
+++ b/modules/serverless-installing-cli-web-console.adoc
@@ -0,0 +1,35 @@
+// Module is included in the following assemblies:
+//
+// serverless/knative-client.adoc
+
+[id="installing-cli-web-console_{context}"]
+= Installing the `kn` CLI using the {product-title} web console
+
+Once the {ServerlessOperatorName} is installed, you will see a link to download the `kn` CLI for Linux, macOS and Windows from the *Command Line Tools* page in the {product-title} web console.
+
+You can access the *Command Line Tools* page by clicking the image:../images/question-circle.png[title="Help"] icon in the top right corner of the web console and selecting *Command Line Tools* in the drop down menu.
+
+.Procedure
+
+. Download the `kn` CLI from the *Command Line Tools* page.
+. Unpack the archive:
++
+----
+$ tar -xf <file>
+----
+. Move the `kn` binary to a directory on your PATH.
+
+. To check your path, run:
++
+----
+$ echo $PATH
+----
++
+[NOTE]
+====
+If you do not use RHEL or Fedora, ensure that *libc* is installed in a directory on your library path.
+If *libc* is not available, you might see the following error when you run CLI commands:
+----
+$ kn: No such file or directory
+----
+====
diff --git a/serverless/knative-client.adoc b/serverless/knative-client.adoc
index 5622e693be..a804e68d05 100644
--- a/serverless/knative-client.adoc
+++ b/serverless/knative-client.adoc
@@ -1,26 +1,29 @@
 [id="knative-client"]
-= Using Knative Client
+= Getting started with Knative Client
 include::modules/common-attributes.adoc[]
 :context: knative-client
 
 toc::[]
 
-Knative Client (`kn`) is the Knative command line interface (CLI). The CLI exposes commands for managing your applications, as well as lower level tools to interact with components of {product-title}. With `kn`, you can create applications and manage {product-title} projects from the terminal.
+Knative Client (`kn`) is the Knative command line interface (CLI).
+The CLI exposes commands for managing your applications, as well as lower level tools to interact with components of {product-title}.
+With `kn`, you can create applications and manage {product-title} projects from the terminal.
 
-Knative client does not have its own log in mechanism. To log in to the cluster you must install the `oc` CLI and use the `oc` login. Installation options for the CLI vary depending on your operating system.
+== Before you begin
 
+Knative Client does not have its own log in mechanism.
+To log in to the cluster you must install the `oc` CLI and use `oc` login.
 
-// Installation
-include::modules/cli-installing-cli.adoc[leveloffset=+1]
-include::modules/serverless-installing-cli-linux.adoc[leveloffset=+2]
+Installation options for the `oc` CLI will vary depending on your operating system.
+For more information on installing the `oc` CLI for your operating system and logging in with `oc`, see the xref:../cli_reference/openshift_cli/getting-started-cli.adoc#cli-getting-started[CLI getting started] documentation.
+
+== Installing Knative Client
+include::modules/serverless-installing-cli-web-console.adoc[leveloffset=+2]
 include::modules/serverless-installing-cli-linux-rpm.adoc[leveloffset=+2]
+include::modules/serverless-installing-cli-linux.adoc[leveloffset=+2]
 include::modules/serverless-installing-cli-macos.adoc[leveloffset=+2]
 include::modules/serverless-installing-cli-windows.adoc[leveloffset=+2]
 
-// Log in
-include::modules/cli-logging-in.adoc[leveloffset=+1]
-
-
 // Access workflows after installation
 // Basic Workflow
 include::modules/serverless-workflow-basic.adoc[leveloffset=+1]