From 200b6be7bd262132a33ead2148f211ae124c4850 Mon Sep 17 00:00:00 2001
From: Camila Macedo <camilamacedo86@gmail.com>
Date: Fri, 23 Aug 2024 12:47:37 +0100
Subject: [PATCH] doc: provide better info about usage of kind

---
 docs/book/src/SUMMARY.md                      |  2 +-
 .../src/cronjob-tutorial/running-webhook.md   | 23 +++++++++----------
 docs/book/src/quick-start.md                  | 12 +++++++++-
 docs/book/src/reference/kind.md               |  9 +++++++-
 4 files changed, 31 insertions(+), 15 deletions(-)

diff --git a/docs/book/src/SUMMARY.md b/docs/book/src/SUMMARY.md
index 1a903ab12f5..041f7bdf59f 100644
--- a/docs/book/src/SUMMARY.md
+++ b/docs/book/src/SUMMARY.md
@@ -78,7 +78,7 @@
   - [Watching Resources](./reference/watching-resources.md)
     - [Resources Managed by the Operator](./reference/watching-resources/operator-managed.md)
     - [Externally Managed Resources](./reference/watching-resources/externally-managed.md)
-  - [Kind cluster](reference/kind.md)
+  - [Kind for Dev & CI](reference/kind.md)
   - [What's a webhook?](reference/webhook-overview.md)
     - [Admission webhook](reference/admission-webhook.md)
     - [Webhooks for Core Types](reference/webhook-for-core-types.md)
diff --git a/docs/book/src/cronjob-tutorial/running-webhook.md b/docs/book/src/cronjob-tutorial/running-webhook.md
index 222b8d645d8..a6cf80318e1 100644
--- a/docs/book/src/cronjob-tutorial/running-webhook.md
+++ b/docs/book/src/cronjob-tutorial/running-webhook.md
@@ -1,15 +1,5 @@
 # Deploying Admission Webhooks
 
-## Kind Cluster
-
-It is recommended to develop your webhook with a
-[kind](../reference/kind.md) cluster for faster iteration.
-Why?
-
-- You can bring up a multi-node cluster locally within 1 minute.
-- You can tear it down in seconds.
-- You don't need to push your images to remote registry.
-
 ## cert-manager
 
 You need to follow [this](./cert-manager.md) to install the cert-manager bundle.
@@ -22,13 +12,22 @@ Run the following command to build your image locally.
 make docker-build docker-push IMG=<some-registry>/<project-name>:tag
 ```
 
-You don't need to push the image to a remote container registry if you are using
-a kind cluster. You can directly load your local image to your specified kind cluster:
+<aside class="note">
+<h1> Using Kind </h1>
+
+Consider incorporating Kind into your workflow for a faster, more efficient local development and CI experience.
+Note that, if you're using a Kind cluster, there's no need to push your image to a remote container registry.
+You can directly load your local image into your specified Kind cluster:
 
 ```bash
 kind load docker-image <your-image-name>:tag --name <your-kind-cluster-name>
 ```
 
+To now more see: [Kind for Dev & CI](./../reference/kind.md)
+
+</aside>
+
+
 ## Deploy Webhooks
 
 You need to enable the webhook and cert manager configuration through kustomize.
diff --git a/docs/book/src/quick-start.md b/docs/book/src/quick-start.md
index 35770f52603..d1ca4351aaa 100644
--- a/docs/book/src/quick-start.md
+++ b/docs/book/src/quick-start.md
@@ -220,11 +220,21 @@ make deploy IMG=<some-registry>/<project-name>:tag
 ```
 
 <aside class="note">
-<h1>registry permission</h1>
+<h1>Registry permission</h1>
 
 This image ought to be published in the personal registry you specified. And it is required to have access to pull the image from the working environment.
 Make sure you have the proper permission to the registry if the above commands don't work.
 
+Consider incorporating Kind into your workflow for a faster, more efficient local development and CI experience.
+Note that, if you're using a Kind cluster, there's no need to push your image to a remote container registry.
+You can directly load your local image into your specified Kind cluster:
+
+```bash
+kind load docker-image <your-image-name>:tag --name <your-kind-cluster-name>
+```
+
+To now more see: [Kind for Dev & CI](./reference/kind.md)
+
 <h1>RBAC errors</h1>
 
 If you encounter RBAC errors, you may need to grant yourself cluster-admin
diff --git a/docs/book/src/reference/kind.md b/docs/book/src/reference/kind.md
index f2ad85bd2ca..f918646b48c 100644
--- a/docs/book/src/reference/kind.md
+++ b/docs/book/src/reference/kind.md
@@ -1,4 +1,11 @@
-# Kind Cluster
+# Using Kind For Development Purposes and CI
+
+## Why Use Kind
+
+- **Fast Setup:** Launch a multi-node Kubernetes cluster locally in under a minute.
+- **Quick Teardown:** Dismantle the cluster in just a few seconds, streamlining your development workflow.
+- **Local Image Usage:** Deploy your container images directly without the need to push to a remote registry.
+- **Lightweight and Efficient:** Kind is a minimalistic Kubernetes distribution, making it perfect for local development and CI/CD pipelines.
 
 This only cover the basics to use a kind cluster. You can find more details at
 [kind documentation](https://kind.sigs.k8s.io/).