From 7fc19f7008a270bbf6f36451edcd5eea3d463c89 Mon Sep 17 00:00:00 2001
From: Massimiliano Giovagnoli <me@maxgio.it>
Date: Mon, 11 Jul 2022 11:22:08 +0200
Subject: [PATCH] docs(getting-started-kind): refactor guide with targets and
 manifests

Signed-off-by: Massimiliano Giovagnoli <me@maxgio.it>
---
 docs/getting-started-with-kamaji.md | 32 +++++++++++++++++++----------
 1 file changed, 21 insertions(+), 11 deletions(-)

diff --git a/docs/getting-started-with-kamaji.md b/docs/getting-started-with-kamaji.md
index 3efe2bb..c0ca647 100644
--- a/docs/getting-started-with-kamaji.md
+++ b/docs/getting-started-with-kamaji.md
@@ -23,23 +23,36 @@ The instance of Kamaji is made of a single node hosting:
 - admin worker
 - multi-tenant etcd cluster
 
-### Requisites
+### Standard
+
+You can install your KinD cluster, ETCD multi-tenant cluster and Kamaji operator with a **single command**:
+
+```bash
+$ make -C deploy/kind
+```
+
+Now you can [create your first `TenantControlPlane`](#deploy-tenant-control-plane).
+
+### Data store-specific
+
+#### ETCD
 
 The multi-tenant etcd cluster is deployed as statefulset into the Kamaji node.
 
 Run `make reqs` to setup Kamaji's requisites on KinD:
 
 ```bash
-$ cd ./deploy/kind
-$ make reqs
+$ make -C deploy/kind reqs
 ```
 
 At this moment you will have your KinD up and running and ETCD cluster in multitenant mode.
 
-Now you're ready to install Kamaji operator.
+Now you're ready to [install Kamaji operator](#install-kamaji).
 
 #### Kine MySQL
 
+> The MySQL-compatible cluster provisioning is omitted here.
+
 Kamaji offers the possibility of using a different storage system than `ETCD` for the tenants, like MySQL compatible databases.
 
 Once a compatible-mysql database is running, we need to provide information about it to kamaji:
@@ -81,17 +94,14 @@ ssl-key=/etc/mysql/conf.d/server.key
 require_secure_transport=ON
 ```
 
-You can read more about it [here](../deploy/mysql/README.md)
+You can read more about it [here](../deploy/mysql/README.md).
+
+Assuming you adjusted the [Kamaji manifest](./config/install.yaml) to connect to the MySQL-compatible database, you can now install it.
 
 ### Install Kamaji
 
 ```bash
-$ kubectl apply -f ../../config/install.yaml
-```
-Otherwise you can install all requisites and Kamaji operator with one single command:
-
-```bash
-$ make kamaji
+$ kubectl apply -f config/install.yaml
 ```
 
 ### Deploy Tenant Control Plane