diff --git a/docs/book/src/developers/development.md b/docs/book/src/developers/development.md
index dd5a217b426..9ae59192255 100644
--- a/docs/book/src/developers/development.md
+++ b/docs/book/src/developers/development.md
@@ -216,7 +216,9 @@ The cluster-api management components that are deployed are configured at the `/
 ⚠️ Note that when developing with `tilt` as described above, some `clusterctl` commands won't work. Specifically, `clusterctl config` and `clusterctl generate` may fail. These commands expect specific releases of CAPI and CAPZ to be installed, but the `tilt` environment dynamically updates and installs these components from your local code. `clusterctl get kubeconfig` will still work, however.
 
 After your kind management cluster is up and running with Tilt, you can deploy a workload cluster by opening the `tilt` web UI and clicking the clockwise arrow icon ⟳ on a resource listed, such as "aks-aad," "ipv6," or "windows."
-Deploying a workload cluster from Tilt UI is also termed as flavor cluster deployment. Please refer [here](../../../../templates/flavors/README.md#Running-flavor-clusters-as-a-tilt-resource) to learn more about this.
+
+Deploying a workload cluster from Tilt UI is also termed as flavor cluster deployment. 
+Please refer to [Running flavor clusters as a tilt resource](../../../../templates/flavors/README.md#Running-flavor-clusters-as-a-tilt-resource) to learn more about this.
 
 Or you can [configure workload cluster settings](#customizing-the-cluster-deployment) and deploy a workload cluster with the following command:
 
diff --git a/templates/flavors/README.md b/templates/flavors/README.md
index 51a309cd0d4..d64c93b5479 100644
--- a/templates/flavors/README.md
+++ b/templates/flavors/README.md
@@ -33,10 +33,10 @@ Please note your tilt-settings.json must contain at minimum the following fields
     }
 }
 ```
-After having the tilt-settings.json, follow these two steps to deploy a workload cluster
+After updating tilt-settings.json, follow these two steps to deploy a workload cluster:
 
-1. ``tilt up`` in the root of cluster-api-provider-azure repo. Note that the tilt-settings.json also resides here in the 
-root of this repo. After this, press `space` to open the tilt UI in browser. See the following example:
+1. Run ``make tilt up`` in the root of cluster-api-provider-azure repo. Note that the tilt-settings.json also resides here in the 
+root of this repo. After tilt has initialized, press `space` to open the tilt web UI in a browser. See the following example:
    ![plot](../../docs/book/theme/tilt-up.png)
 2. Once your browser is open, click the clockwise arrow icon ⟳ on a resource listed. For example, `default` to deploy a default flavor.
    ![plot](../../docs/book/theme/flavour-deploy-from-ui.png)