Apply suggestions from code review

Co-authored-by: Jason DeTiberus <[email protected]>

Author: fiunchinho

docs/proposals/20190919-machinepool-api.md

@@ -168,8 +168,7 @@ type MachinePoolSpec struct
     - Description: Name of the Cluster this machine pool belongs to.
   - **FailureDomains [optional]**
     - Type: `FailureDomains`
-    - Description: FailureDomainSpec is the Schema for Cluster API failure domains.
-      It allows controllers to understand how many failure domains a cluster can optionally span across.
+    - Description: FailureDomains are the failure domains the MachinePool instances should be be created in.
   - **Replicas [optional]**
     - Type: `*int32`
     - Description: Number of desired machine instances. Defaults to 1.
@@ -419,4 +418,3 @@ inconsistent experience across providers.
 10/23/2019: First round of feedback from community
 10/23/2019: Present proposal at a community meeting
 10/31/2019: Open proposal PR
-

exp/api/v1alpha3/machinepool_types.go

@@ -60,7 +60,7 @@ type MachinePoolSpec struct {
 	// +optional
 	ProviderIDList []string `json:"providerIDList,omitempty"`
 
-	// FailureDomains is the list of failure domains this MachinePool should be attached to.
+	// FailureDomains are the failure domains the MachinePool instances should be be created in.
 	FailureDomains clusterv1.FailureDomains `json:"failureDomains,omitempty"`
 }