Updating install flow with minor changes to reflect desired prototype in UX/11

docs/client/install-kn.md

@@ -8,6 +8,15 @@ aliases:
 
 This guide provides details about how you can set up the Knative `kn` CLI.
 
+## Install kn using brew
+
+For macOS, you can install `kn` by using <a href="https://github.com/knative/homebrew-client" target="_blank">Homebrew</a>.
+
+```
+brew install kn
+```
+
+
 ## Install kn using a binary
 
 You can install `kn` by downloading the executable binary for your system and placing it in the system path.
@@ -47,10 +56,6 @@ Links to the latest nightly-built executable binaries are available here:
       kn version
       ```
 
-## Install kn using brew
-
-For macOs, you can install `kn` by using <a href="https://github.com/knative/homebrew-client" target="_blank">brew</a>.
-
 ## Running kn using container images
 
 **WARNING:** Nightly container images include features which may not be included in the latest Knative release and are not considered to be stable.

docs/install/_index.md

@@ -23,9 +23,7 @@ showlandingtoc: "false"
 
 You can install the Serving component, Eventing component, or both on your cluster by using one of the following deployment options:
 
-- Using a YAML-based installation:
-  - [Installing Serving using YAML files](./install-serving-with-yaml)
-  - [Installing Eventing using YAML files](./install-eventing-with-yaml)
+- Using a [YAML-based installation](./prerequisites.md)
 - Using the [Knative Operator](./knative-with-operators).
 - Following the documentation for vendor managed [Knative offerings](../knative-offerings).
 

docs/install/install-eventing-with-yaml.md

@@ -31,6 +31,9 @@ To install the Eventing component:
    kubectl apply -f {{< artifact repo="eventing" file="eventing-core.yaml" >}}
    ```
 
+For information about the YAML files in the Knative Serving and Eventing releases, see
+[Installation files](./installation-files.md).
+
 
 ## Verify the installation
 
@@ -218,6 +221,8 @@ data:
 
 After installing Knative Eventing:
 
-- If you want to add extra features to your installation, see [Installing optional extensions](./install-extensions.md).
-- If you want to install the Knative Serving component, see [Installing Serving using YAML files](./install-serving-with-yaml.md)
-- Install the [Knative CLI](./install-kn) to use `kn` commands.
+- To easily interact with Knative Eventing components, [install the `kn` CLI](/docs/client/install-kn.md)
+
+- To add optional enhancements to your installation, see [Installing optional extensions](./install-extensions.md)
+
+- [Installing Knative Serving using YAML files](./install-serving-with-yaml.md)

docs/install/install-extensions.md

@@ -17,7 +17,7 @@ For information about the YAML files in the Knative Serving and Eventing release
 
 Before you install any optional extensions, you must install Knative Serving or Eventing.
 See [Installing Serving using YAML files](./install-serving-with-yaml.md)
-and [Installing Eventing using YAML files](./install/install-eventing-with-yaml.md).
+and [Installing Eventing using YAML files](./install-eventing-with-yaml.md).
 
 
 ## Install optional Serving extensions
@@ -276,3 +276,7 @@ To learn more about the VMware sources and bindings, try
 {{< /tab >}}
 
 {{< /tabs >}}
+
+## Next steps
+
+- To easily interact with Knative Services and Eventing components, [install the `kn` CLI](/docs/client/install-kn.md)

docs/install/install-serving-with-yaml.md

@@ -25,11 +25,13 @@ To install the serving component:
    kubectl apply -f {{< artifact repo="serving" file="serving-crds.yaml" >}}
    ```
 
-1. Install the core components of Serving:
+1. Install the core components of Knative Serving:
 
    ```bash
    kubectl apply -f {{< artifact repo="serving" file="serving-core.yaml" >}}
    ```
+For information about the YAML files in the Knative Serving and Eventing releases, see
+[Installation files](./installation-files.md).
 
 
 ## Install a networking layer
@@ -373,6 +375,8 @@ Refer to the "Real DNS" method for a permanent solution.
 
 After installing Knative Serving:
 
-- If you want to add extra features to your installation, see [Installing optional extensions](./install-extensions.md).
-- If you want to install the Knative Eventing component, see [Installing Eventing using YAML files](./install-eventing-with-yaml.md)
-- Install the [Knative CLI](./install-kn) to use `kn` commands.
+- [Installing Knative Eventing using YAML files](./install-eventing-with-yaml.md)
+
+- To add optional enhancements to your installation, see [Installing optional extensions](./install-extensions.md).
+
+- To easily interact with Knative Services, [install the `kn` CLI](/docs/client/install-kn.md)

docs/install/prerequisites.md

@@ -9,10 +9,10 @@ Before installing Knative, you must meet the following prerequisites:
 
 ## System requirements
 
-For prototyping purposes, Knative will work on most local deployments of Kubernetes.
+**For prototyping purposes**, Knative will work on most local deployments of Kubernetes.
 For example, you can use a local, one-node cluster that has 2 CPU and 4GB of memory.
 
-For production purposes, it is recommended that:
+**For production purposes**, it is recommended that:
 - If you have only one node in your cluster, you will need at least 6 CPUs, 6 GB of memory, and 30 GB of disk storage.
 - If you have multiple nodes in your cluster, for each node you will need at least 2 CPUs, 4 GB of memory, and 20 GB of disk storage.
 <!--TODO: Verify these requirements-->
@@ -26,4 +26,11 @@ Before installation, you must meet the following prerequisites:
 
 - You have a cluster that uses Kubernetes v1.18 or newer.
 - You have installed the [`kubectl` CLI](https://kubernetes.io/docs/tasks/tools/install-kubectl/).
-- Your Kubernetes cluster must have access to the internet, since Kubernetes needs to be able to fetch images.
+- Your Kubernetes cluster must have access to the internet, since Kubernetes needs to be able to fetch images. (To pull from a private registry, see [Deploying images from a private container registry](https://knative.dev/docs/serving/deploying/private-registry/))
+
+## Next Steps: Install Knative Serving and Eventing
+
+You can install the Serving component, Eventing component, or both on your cluster. If you're planning on installing both, **we recommend starting with Knative Serving.**
+
+  - [Installing Knative Serving using YAML files](./install-serving-with-yaml)
+  - [Installing Knative Eventing using YAML files](./install-eventing-with-yaml)