Updates from review

Author: aleskandro

docs/proposals/20210310-opt-in-autoscaling-from-zero.md

@@ -179,7 +179,9 @@ const (
 // DockerMachineTemplateStatus defines the observed state of a DockerMachineTemplate
 type DockerMachineTemplateStatus struct {
     Capacity corev1.ResourceList `json:"capacity,omitempty"`
-    NodeInfo *platform.NodeSystemInfo `json:"nodeInfo,omitempty"`
+    
+    // +optional
+    NodeInfo *platform.NodeInfo `json:"nodeInfo,omitempty"`
 }
 
 // DockerMachineTemplate is the Schema for the dockermachinetemplates API.
@@ -201,17 +203,26 @@ Its definition would look like this:
 ```go
 package platform
 
+// Architecture represents the architecture of the node. Its underlying type is a string.
+// +enum
 type Architecture string
 
+// Architecture constants defined for clarity and to be used by the cluster-api providers.
 const (
     ArchitectureAmd64 Architecture = "amd64"
     ArchitectureArm64 Architecture = "arm64"
     ArchitectureS390x Architecture = "s390x"
     ArchitecturePpc64le Architecture = "ppc64le"
 )
 
-type NodeSystemInfo struct {
+// NodeInfo contains information about the node's architecture and operating system.
+type NodeInfo struct {
+    // Architecture is the architecture of the node. It is a string that can be any of (amd64, arm64, s390x, ppc64le).
+    // +optional
+    // +kubebuilder:validation:Enum=amd64;arm64;s390x;ppc64le
     Architecture Architecture `json:"architecture,omitempty"`
+    // OperatingSystem is a string representing the operating system of the node. 
+    // +optional
     OperatingSystem string `json:"operatingSystem,omitempty"`
 }
 ```