diff --git a/docs/client/install-kn.md b/docs/client/install-kn.md
index e48e15ff7b3..4258cf389ed 100644
--- a/docs/client/install-kn.md
+++ b/docs/client/install-kn.md
@@ -8,15 +8,6 @@ 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 Homebrew.
-
-```
-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.
@@ -56,6 +47,10 @@ 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 brew.
+
## 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.
diff --git a/docs/install/_index.md b/docs/install/_index.md
index 75f7a40ad0b..3f9af43988e 100644
--- a/docs/install/_index.md
+++ b/docs/install/_index.md
@@ -23,7 +23,9 @@ 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](./prerequisites.md)
+- Using a YAML-based installation:
+ - [Installing Serving using YAML files](./install-serving-with-yaml)
+ - [Installing Eventing using YAML files](./install-eventing-with-yaml)
- Using the [Knative Operator](./knative-with-operators).
- Following the documentation for vendor managed [Knative offerings](../knative-offerings).
diff --git a/docs/install/install-eventing-with-yaml.md b/docs/install/install-eventing-with-yaml.md
index 38a0304f31c..1d2723aadbe 100644
--- a/docs/install/install-eventing-with-yaml.md
+++ b/docs/install/install-eventing-with-yaml.md
@@ -31,9 +31,6 @@ 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
@@ -221,8 +218,6 @@ data:
After installing Knative Eventing:
-- To easily interact with Knative Eventing Components, [download the `kn` CLI](/docs/client/install-kn.md)
-
-- If you want 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)
+- 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.
diff --git a/docs/install/install-extensions.md b/docs/install/install-extensions.md
index 8ed2fad5dfd..80dc6808ac8 100644
--- a/docs/install/install-extensions.md
+++ b/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-eventing-with-yaml.md).
+and [Installing Eventing using YAML files](./install/install-eventing-with-yaml.md).
## Install optional Serving extensions
@@ -276,7 +276,3 @@ To learn more about the VMware sources and bindings, try
{{< /tab >}}
{{< /tabs >}}
-
-## Next steps
-
-- To easily interact with Knative Services and Eventing Components, [download the `kn` CLI](/docs/client/install-kn.md)
diff --git a/docs/install/install-serving-with-yaml.md b/docs/install/install-serving-with-yaml.md
index dcae78a2106..a7fbfaeb1ee 100644
--- a/docs/install/install-serving-with-yaml.md
+++ b/docs/install/install-serving-with-yaml.md
@@ -25,13 +25,11 @@ To install the serving component:
kubectl apply -f {{< artifact repo="serving" file="serving-crds.yaml" >}}
```
-1. Install the core components of Knative Serving:
+1. Install the core components of 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
@@ -375,8 +373,6 @@ Refer to the "Real DNS" method for a permanent solution.
After installing Knative Serving:
-- [Installing Knative Eventing using YAML files](./install-eventing-with-yaml.md)
-
-- If you want to add optional enhancements to your installation, see [Installing optional extensions](./install-extensions.md).
-
-- To easily interact with Knative Services, [download the `kn` CLI](/docs/client/install-kn.md)
+- 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.
diff --git a/docs/install/prerequisites.md b/docs/install/prerequisites.md
index 03c21988a26..b77e54cd22d 100644
--- a/docs/install/prerequisites.md
+++ b/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.
@@ -26,11 +26,4 @@ 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. (To pull from a private registry, see [Deploying images from a private container registry](https://knative.dev/docs/serving/deploying/private-registry/))
-
-## 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)
+- Your Kubernetes cluster must have access to the internet, since Kubernetes needs to be able to fetch images.