Clean and regen docs (#401)

diff --git a/docs/dyn/compute_alpha.regionAutoscalers.html b/docs/dyn/compute_alpha.regionAutoscalers.html
index e35607f..873708b 100644
--- a/docs/dyn/compute_alpha.regionAutoscalers.html
+++ b/docs/dyn/compute_alpha.regionAutoscalers.html
@@ -197,14 +197,13 @@
         },
         "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
           { # Custom utilization metric policy.
-            "metric": "A String", # The identifier of the Stackdriver Monitoring metric. The metric cannot have negative values and should be a utilization metric, which means that the number of virtual machines handling requests should increase or decrease proportionally to the metric. The metric must also have a label of compute.googleapis.com/resource_id with the value of the instance's unique ID, although this alone does not guarantee that the metric is valid.
+            "metric": "A String", # The identifier (type) of the Stackdriver Monitoring metric. The metric cannot have negative values and should be a utilization metric, which means that the number of virtual machines handling requests should increase or decrease proportionally to the metric.
                 #
-                # For example, the following is a valid metric:
-                # compute.googleapis.com/instance/network/received_bytes_count
-                # The following is not a valid metric because it does not increase or decrease based on usage:
-                # compute.googleapis.com/instance/cpu/reserved_cores
+                # The metric must have a value type of INT64 or DOUBLE.
             "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE. If not specified, the default is GAUGE.
-            "utilizationTarget": 3.14, # Target value of the metric which autoscaler should maintain. Must be a positive value.
+            "utilizationTarget": 3.14, # The target value of the metric that autoscaler should maintain. This must be a positive value.
+                #
+                # For example, a good metric to use as a utilization_target is compute.googleapis.com/instance/network/received_bytes_count. The autoscaler will work to keep this value constant for each of the instances.
           },
         ],
         "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale based on the average CPU utilization of a managed instance group.
@@ -266,14 +265,13 @@
       },
       "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
         { # Custom utilization metric policy.
-          "metric": "A String", # The identifier of the Stackdriver Monitoring metric. The metric cannot have negative values and should be a utilization metric, which means that the number of virtual machines handling requests should increase or decrease proportionally to the metric. The metric must also have a label of compute.googleapis.com/resource_id with the value of the instance's unique ID, although this alone does not guarantee that the metric is valid.
+          "metric": "A String", # The identifier (type) of the Stackdriver Monitoring metric. The metric cannot have negative values and should be a utilization metric, which means that the number of virtual machines handling requests should increase or decrease proportionally to the metric.
               #
-              # For example, the following is a valid metric:
-              # compute.googleapis.com/instance/network/received_bytes_count
-              # The following is not a valid metric because it does not increase or decrease based on usage:
-              # compute.googleapis.com/instance/cpu/reserved_cores
+              # The metric must have a value type of INT64 or DOUBLE.
           "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE. If not specified, the default is GAUGE.
-          "utilizationTarget": 3.14, # Target value of the metric which autoscaler should maintain. Must be a positive value.
+          "utilizationTarget": 3.14, # The target value of the metric that autoscaler should maintain. This must be a positive value.
+              #
+              # For example, a good metric to use as a utilization_target is compute.googleapis.com/instance/network/received_bytes_count. The autoscaler will work to keep this value constant for each of the instances.
         },
       ],
       "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale based on the average CPU utilization of a managed instance group.
@@ -406,14 +404,13 @@
             },
             "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
               { # Custom utilization metric policy.
-                "metric": "A String", # The identifier of the Stackdriver Monitoring metric. The metric cannot have negative values and should be a utilization metric, which means that the number of virtual machines handling requests should increase or decrease proportionally to the metric. The metric must also have a label of compute.googleapis.com/resource_id with the value of the instance's unique ID, although this alone does not guarantee that the metric is valid.
+                "metric": "A String", # The identifier (type) of the Stackdriver Monitoring metric. The metric cannot have negative values and should be a utilization metric, which means that the number of virtual machines handling requests should increase or decrease proportionally to the metric.
                     #
-                    # For example, the following is a valid metric:
-                    # compute.googleapis.com/instance/network/received_bytes_count
-                    # The following is not a valid metric because it does not increase or decrease based on usage:
-                    # compute.googleapis.com/instance/cpu/reserved_cores
+                    # The metric must have a value type of INT64 or DOUBLE.
                 "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE. If not specified, the default is GAUGE.
-                "utilizationTarget": 3.14, # Target value of the metric which autoscaler should maintain. Must be a positive value.
+                "utilizationTarget": 3.14, # The target value of the metric that autoscaler should maintain. This must be a positive value.
+                    #
+                    # For example, a good metric to use as a utilization_target is compute.googleapis.com/instance/network/received_bytes_count. The autoscaler will work to keep this value constant for each of the instances.
               },
             ],
             "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale based on the average CPU utilization of a managed instance group.
@@ -494,14 +491,13 @@
       },
       "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
         { # Custom utilization metric policy.
-          "metric": "A String", # The identifier of the Stackdriver Monitoring metric. The metric cannot have negative values and should be a utilization metric, which means that the number of virtual machines handling requests should increase or decrease proportionally to the metric. The metric must also have a label of compute.googleapis.com/resource_id with the value of the instance's unique ID, although this alone does not guarantee that the metric is valid.
+          "metric": "A String", # The identifier (type) of the Stackdriver Monitoring metric. The metric cannot have negative values and should be a utilization metric, which means that the number of virtual machines handling requests should increase or decrease proportionally to the metric.
               #
-              # For example, the following is a valid metric:
-              # compute.googleapis.com/instance/network/received_bytes_count
-              # The following is not a valid metric because it does not increase or decrease based on usage:
-              # compute.googleapis.com/instance/cpu/reserved_cores
+              # The metric must have a value type of INT64 or DOUBLE.
           "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE. If not specified, the default is GAUGE.
-          "utilizationTarget": 3.14, # Target value of the metric which autoscaler should maintain. Must be a positive value.
+          "utilizationTarget": 3.14, # The target value of the metric that autoscaler should maintain. This must be a positive value.
+              #
+              # For example, a good metric to use as a utilization_target is compute.googleapis.com/instance/network/received_bytes_count. The autoscaler will work to keep this value constant for each of the instances.
         },
       ],
       "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale based on the average CPU utilization of a managed instance group.
@@ -643,14 +639,13 @@
       },
       "customMetricUtilizations": [ # Configuration parameters of autoscaling based on a custom metric.
         { # Custom utilization metric policy.
-          "metric": "A String", # The identifier of the Stackdriver Monitoring metric. The metric cannot have negative values and should be a utilization metric, which means that the number of virtual machines handling requests should increase or decrease proportionally to the metric. The metric must also have a label of compute.googleapis.com/resource_id with the value of the instance's unique ID, although this alone does not guarantee that the metric is valid.
+          "metric": "A String", # The identifier (type) of the Stackdriver Monitoring metric. The metric cannot have negative values and should be a utilization metric, which means that the number of virtual machines handling requests should increase or decrease proportionally to the metric.
               #
-              # For example, the following is a valid metric:
-              # compute.googleapis.com/instance/network/received_bytes_count
-              # The following is not a valid metric because it does not increase or decrease based on usage:
-              # compute.googleapis.com/instance/cpu/reserved_cores
+              # The metric must have a value type of INT64 or DOUBLE.
           "utilizationTargetType": "A String", # Defines how target utilization value is expressed for a Stackdriver Monitoring metric. Either GAUGE, DELTA_PER_SECOND, or DELTA_PER_MINUTE. If not specified, the default is GAUGE.
-          "utilizationTarget": 3.14, # Target value of the metric which autoscaler should maintain. Must be a positive value.
+          "utilizationTarget": 3.14, # The target value of the metric that autoscaler should maintain. This must be a positive value.
+              #
+              # For example, a good metric to use as a utilization_target is compute.googleapis.com/instance/network/received_bytes_count. The autoscaler will work to keep this value constant for each of the instances.
         },
       ],
       "cpuUtilization": { # CPU utilization policy. # Defines the CPU utilization policy that allows the autoscaler to scale based on the average CPU utilization of a managed instance group.