Clean and regen docs (#401)

diff --git a/docs/dyn/compute_alpha.autoscalers.html b/docs/dyn/compute_alpha.autoscalers.html
index 33698a1..be6c756 100644
--- a/docs/dyn/compute_alpha.autoscalers.html
+++ b/docs/dyn/compute_alpha.autoscalers.html
@@ -173,14 +173,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.
@@ -325,14 +324,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.
@@ -394,14 +392,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.
@@ -534,14 +531,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.
@@ -622,14 +618,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.
@@ -771,14 +766,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.