diff --git a/Makefile b/Makefile
index b718ef18..b8e26809 100644
--- a/Makefile
+++ b/Makefile
@@ -370,15 +370,15 @@ test-apply: set-hmc-version helm-package dev-deploy dev-templates dev-release
 dev-destroy: kind-undeploy registry-undeploy ## Destroy the development environment by deleting the kind cluster and local registry.
 
 .PHONY: dev-mcluster-apply
-dev-mcluster-apply: envsubst
+dev-mcluster-apply: envsubst ## Create dev managed cluster using 'config/dev/$(DEV_PROVIDER)-clusterdeployment.yaml'
 	@NAMESPACE=$(NAMESPACE) $(ENVSUBST) -no-unset -i config/dev/$(DEV_PROVIDER)-clusterdeployment.yaml | $(KUBECTL) apply -f -
 
 .PHONY: dev-mcluster-delete
-dev-mcluster-delete: envsubst
+dev-mcluster-delete: envsubst ## Delete dev managed cluster using 'config/dev/$(DEV_PROVIDER)-clusterdeployment.yaml'
 	@NAMESPACE=$(NAMESPACE) $(ENVSUBST) -no-unset -i config/dev/$(DEV_PROVIDER)-clusterdeployment.yaml | $(KUBECTL) delete -f -
 
 .PHONY: dev-creds-apply
-dev-creds-apply: dev-$(DEV_PROVIDER)-creds
+dev-creds-apply: dev-$(DEV_PROVIDER)-creds ## Create credentials resources for $DEV_PROVIDER
 
 .PHONY: dev-aws-nuke
 dev-aws-nuke: envsubst awscli yq cloud-nuke ## Warning: Destructive! Nuke all AWS resources deployed by 'DEV_PROVIDER=aws dev-mcluster-apply'
diff --git a/README.md b/README.md
index f43a6131..1ede333b 100644
--- a/README.md
+++ b/README.md
@@ -29,7 +29,7 @@ or install using `helm`
 helm install hmc oci://ghcr.io/k0rdent/kcm/charts/hmc --version 0.0.6 -n hmc-system --create-namespace
 ```
 
-Then follow the [Deploy a cluster deployment](#deploy-a-cluster-deployment) guide to
+Then follow the [Deploy a cluster deployment](#create-a-clusterdeployment) guide to
 create a cluster deployment.
 
 > [!NOTE]
diff --git a/docs/dev.md b/docs/dev.md
index af5b9d3f..2df2c980 100644
--- a/docs/dev.md
+++ b/docs/dev.md
@@ -22,7 +22,7 @@ make cli-install
 
 ### AWS Provider Setup
 
-Follow the instruction to configure AWS Provider: [AWS Provider Setup](aws/main.md#prepare-the-aws-infra-provider)
+Follow the instruction to configure AWS Provider: [AWS Provider Setup](https://k0rdent.github.io/docs/quick-start/aws/)
 
 The following env variables must be set in order to deploy dev cluster on AWS:
 
@@ -36,7 +36,7 @@ The following environment variables are optional but can enhance functionality:
 
 ### Azure Provider Setup
 
-Follow the instruction on how to configure [Azure Provider](azure/main.md).
+Follow the instruction on how to configure [Azure Provider](https://k0rdent.github.io/docs/quick-start/azure/).
 
 Additionally to deploy dev cluster on Azure the following env variables should
 be set before running deployment:
@@ -51,7 +51,7 @@ More detailed description of these parameters can be found
 
 ### vSphere Provider Setup
 
-Follow the instruction on how to configure [vSphere Provider](vsphere/main.md).
+Follow the instruction on how to configure [vSphere Provider](https://k0rdent.github.io/docs/quick-start/vsphere/).
 
 To properly deploy dev cluster you need to have the following variables set: