[WIP] #3078: Clean up Kafka docs

docs/developer/eventing/kafka/README.md

@@ -0,0 +1,15 @@
+# Using Apache Kafka with Knative
+
+If you want to use Apache Kafka with Knative, you can either install Apache Kafka directly, use an existing Kafka cluster, or use [Strimzi](https://strimzi.io/docs/operators/in-development/full/overview.html) to create a simplified Kafka deployment on Kubernetes.
+
+## Prerequisites
+
+- You will need a Kubernetes cluster with [Knative Eventing installed](../../../../admin/install).
+
+    !!! tip
+        You can use a `kind` cluster for local development and follow the [Getting Started](../../../../getting-started) documentation to install Knative by using the `konk` script.
+
+- If you do not have an existing Kafka cluster:
+    - [Install Strimzi](https://strimzi.io/docs/operators/in-development/quickstart.html#proc-install-product-str).
+    - [Create a Kafka cluster](https://strimzi.io/docs/operators/in-development/quickstart.html#proc-kafka-cluster-str).
+    - You can also use the [Strimzi Quickstart guide](https://strimzi.io/quickstarts/) to complete these tasks.

mkdocs.yml

@@ -71,6 +71,8 @@ nav:
             - Configure resource requests and limits: developer/serving/services/configure-requests-limits-services.md
           - Troubleshooting:
             - Debugging application issues: developer/serving/troubleshooting/debugging-application-issues.md
+        - Knative Eventing:
+          - Using Apache Kafka with Knative: developer/eventing/kafka/README.md
     # Serving
     - Knative Serving:
       - Overview: serving/README.md
@@ -292,6 +294,7 @@ plugins:
 # Redirects
   - redirects:
       redirect_maps:
+        'eventing/samples/kafka/README.md': 'developer/eventing/kafka/README.md'
         'help/README.md': 'docs/help/contributor/README.md'
         'serving/metrics.md': 'admin/collecting-metrics/serving-metrics/metrics.md'
         'eventing/metrics.md': 'admin/collecting-metrics/eventing-metrics/metrics.md'