Update bootstrap/kubeadm/api/v1alpha3/kubeadmbootstrapconfig_types.go

Co-Authored-By: Vince Prignano <[email protected]>

bootstrap/kubeadm/api/v1alpha3/kubeadmbootstrapconfig_types.go

@@ -75,7 +75,12 @@ type KubeadmConfigSpec struct {
 	Verbosity *int32 `json:"verbosity,omitempty"`
 
 	// UseExperimentalRetryJoin replaces a basic kubeadm command with a shell
-	// script with retries for control plane joins
+	// script with retries for control plane joins.
+	// 
+	// This is meant to be an experimental temporary workaround on some environments
+	// where joins fail due to timing (and other issues). The long term goal is to add retries to 
+	// kubeadm proper and use that functionality. 
+	// For more information, refer to https://github.com/kubernetes-sigs/cluster-api/pull/2763#discussion_r397306055.
 	// +optional
 	UseExperimentalRetryJoin bool `json:"useExperimentalRetryJoin,omitempty"`
 }