build: run docs regen in synth.py (#1059)

diff --git a/docs/dyn/bigqueryreservation_v1.projects.locations.reservations.html b/docs/dyn/bigqueryreservation_v1.projects.locations.reservations.html
index a2b3dab..9be3d94 100644
--- a/docs/dyn/bigqueryreservation_v1.projects.locations.reservations.html
+++ b/docs/dyn/bigqueryreservation_v1.projects.locations.reservations.html
@@ -92,7 +92,7 @@
   <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
 <p class="firstline">Returns information about the reservation.</p>
 <p class="toc_element">
-  <code><a href="#list">list(parent, pageToken=None, pageSize=None, x__xgafv=None)</a></code></p>
+  <code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Lists all the reservations for the project in the specified location.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -116,12 +116,12 @@
     The object takes the form of:
 
 { # A reservation is a mechanism used to guarantee slots to users.
-    &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or if total slot capacity of the new reservation and its siblings exceeds the parent&#x27;s slot capacity, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`.
-    &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other reservations within the same admin project. If true, a query using this reservation will execute with the slot capacity specified above at most.
-    &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last update time of the reservation.
-    &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
-    &quot;creationTime&quot;: &quot;A String&quot;, # Output only. Creation time of the reservation.
-  }
+  &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or if total slot capacity of the new reservation and its siblings exceeds the parent&#x27;s slot capacity, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`.
+  &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last update time of the reservation.
+  &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other reservations within the same admin project. If true, a query using this reservation will execute with the slot capacity specified above at most.
+  &quot;creationTime&quot;: &quot;A String&quot;, # Output only. Creation time of the reservation.
+  &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+}
 
   reservationId: string, The reservation ID. This field must only contain lower case alphanumeric characters or dash. Max length is 64 characters.
   x__xgafv: string, V1 error format.
@@ -133,12 +133,12 @@
   An object of the form:
 
     { # A reservation is a mechanism used to guarantee slots to users.
-      &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or if total slot capacity of the new reservation and its siblings exceeds the parent&#x27;s slot capacity, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`.
-      &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other reservations within the same admin project. If true, a query using this reservation will execute with the slot capacity specified above at most.
-      &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last update time of the reservation.
-      &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
-      &quot;creationTime&quot;: &quot;A String&quot;, # Output only. Creation time of the reservation.
-    }</pre>
+    &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or if total slot capacity of the new reservation and its siblings exceeds the parent&#x27;s slot capacity, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`.
+    &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last update time of the reservation.
+    &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other reservations within the same admin project. If true, a query using this reservation will execute with the slot capacity specified above at most.
+    &quot;creationTime&quot;: &quot;A String&quot;, # Output only. Creation time of the reservation.
+    &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+  }</pre>
 </div>
 
 <div class="method">
@@ -174,22 +174,22 @@
   An object of the form:
 
     { # A reservation is a mechanism used to guarantee slots to users.
-      &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or if total slot capacity of the new reservation and its siblings exceeds the parent&#x27;s slot capacity, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`.
-      &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other reservations within the same admin project. If true, a query using this reservation will execute with the slot capacity specified above at most.
-      &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last update time of the reservation.
-      &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
-      &quot;creationTime&quot;: &quot;A String&quot;, # Output only. Creation time of the reservation.
-    }</pre>
+    &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or if total slot capacity of the new reservation and its siblings exceeds the parent&#x27;s slot capacity, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`.
+    &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last update time of the reservation.
+    &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other reservations within the same admin project. If true, a query using this reservation will execute with the slot capacity specified above at most.
+    &quot;creationTime&quot;: &quot;A String&quot;, # Output only. Creation time of the reservation.
+    &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+  }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(parent, pageToken=None, pageSize=None, x__xgafv=None)</code>
+    <code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
   <pre>Lists all the reservations for the project in the specified location.
 
 Args:
   parent: string, Required. The parent resource name containing project and location, e.g.: `projects/myproject/locations/US` (required)
-  pageToken: string, The next_page_token value returned from a previous List request, if any.
   pageSize: integer, The maximum number of items to return per page.
+  pageToken: string, The next_page_token value returned from a previous List request, if any.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -201,12 +201,12 @@
     { # The response for ReservationService.ListReservations.
     &quot;reservations&quot;: [ # List of reservations visible to the user.
       { # A reservation is a mechanism used to guarantee slots to users.
-          &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or if total slot capacity of the new reservation and its siblings exceeds the parent&#x27;s slot capacity, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`.
-          &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other reservations within the same admin project. If true, a query using this reservation will execute with the slot capacity specified above at most.
-          &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last update time of the reservation.
-          &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
-          &quot;creationTime&quot;: &quot;A String&quot;, # Output only. Creation time of the reservation.
-        },
+        &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or if total slot capacity of the new reservation and its siblings exceeds the parent&#x27;s slot capacity, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`.
+        &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last update time of the reservation.
+        &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other reservations within the same admin project. If true, a query using this reservation will execute with the slot capacity specified above at most.
+        &quot;creationTime&quot;: &quot;A String&quot;, # Output only. Creation time of the reservation.
+        &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+      },
     ],
     &quot;nextPageToken&quot;: &quot;A String&quot;, # Token to retrieve the next page of results, or empty if there are no more results in the list.
   }</pre>
@@ -236,12 +236,12 @@
     The object takes the form of:
 
 { # A reservation is a mechanism used to guarantee slots to users.
-    &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or if total slot capacity of the new reservation and its siblings exceeds the parent&#x27;s slot capacity, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`.
-    &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other reservations within the same admin project. If true, a query using this reservation will execute with the slot capacity specified above at most.
-    &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last update time of the reservation.
-    &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
-    &quot;creationTime&quot;: &quot;A String&quot;, # Output only. Creation time of the reservation.
-  }
+  &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or if total slot capacity of the new reservation and its siblings exceeds the parent&#x27;s slot capacity, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`.
+  &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last update time of the reservation.
+  &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other reservations within the same admin project. If true, a query using this reservation will execute with the slot capacity specified above at most.
+  &quot;creationTime&quot;: &quot;A String&quot;, # Output only. Creation time of the reservation.
+  &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+}
 
   updateMask: string, Standard field mask for the set of fields to be updated.
   x__xgafv: string, V1 error format.
@@ -253,12 +253,12 @@
   An object of the form:
 
     { # A reservation is a mechanism used to guarantee slots to users.
-      &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or if total slot capacity of the new reservation and its siblings exceeds the parent&#x27;s slot capacity, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`.
-      &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other reservations within the same admin project. If true, a query using this reservation will execute with the slot capacity specified above at most.
-      &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last update time of the reservation.
-      &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
-      &quot;creationTime&quot;: &quot;A String&quot;, # Output only. Creation time of the reservation.
-    }</pre>
+    &quot;slotCapacity&quot;: &quot;A String&quot;, # Minimum slots available to this reservation. A slot is a unit of computational power in BigQuery, and serves as the unit of parallelism. Queries using this reservation might use more slots during runtime if ignore_idle_slots is set to false. If the new reservation&#x27;s slot capacity exceed the parent&#x27;s slot capacity or if total slot capacity of the new reservation and its siblings exceeds the parent&#x27;s slot capacity, the request will fail with `google.rpc.Code.RESOURCE_EXHAUSTED`.
+    &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last update time of the reservation.
+    &quot;ignoreIdleSlots&quot;: True or False, # If false, any query using this reservation will use idle slots from other reservations within the same admin project. If true, a query using this reservation will execute with the slot capacity specified above at most.
+    &quot;creationTime&quot;: &quot;A String&quot;, # Output only. Creation time of the reservation.
+    &quot;name&quot;: &quot;A String&quot;, # The resource name of the reservation, e.g., `projects/*/locations/*/reservations/team1-prod`.
+  }</pre>
 </div>
 
 </body></html>
\ No newline at end of file