chore: regens API reference docs (#889)

diff --git a/docs/dyn/run_v1alpha1.projects.locations.routes.html b/docs/dyn/run_v1alpha1.projects.locations.routes.html
index 4d34f7f..6872a9e 100644
--- a/docs/dyn/run_v1alpha1.projects.locations.routes.html
+++ b/docs/dyn/run_v1alpha1.projects.locations.routes.html
@@ -108,9 +108,9 @@
       # automatically deploy the "latest ready" Revision from that Configuration.
     "status": { # RouteStatus communicates the observed state of the Route (from the # Status communicates the observed state of the Route (from the controller).
         # controller).
-      "domain": "A String", # Domain holds the top-level domain that will distribute traffic over the
-          # provided targets. It generally has the form
-          # https://{route-hash}-{project-hash}-{cluster-level-suffix}.a.run.app
+      "domain": "A String", # Deprecated - use url instead.
+          # Domain holds the top-level domain that will distribute traffic over the
+          # provided targets.
       "observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Route that
           # was last processed by the controller.
           #
@@ -122,6 +122,9 @@
           # result in a Route that does not increment either its metadata.generation or
           # its observedGeneration, as new "latest ready" revisions from the
           # Configuration are processed without an update to the Route's spec.
+      "url": "A String", # URL holds the url that will distribute traffic over the provided traffic
+          # targets. It generally has the form
+          # https://{route-hash}-{project-hash}-{cluster-level-suffix}.a.run.app
       "traffic": [ # Traffic holds the configured traffic distribution.
           # These entries will always contain RevisionName references.
           # When ConfigurationName appears in the spec, this will hold the
@@ -131,8 +134,6 @@
               # ready Revision of the Configuration should be used for this traffic
               # target. When provided LatestRevision must be true if RevisionName is
               # empty; it must be false when RevisionName is non-empty.
-              #
-              # Not currently supported in Cloud Run.
               # +optional
           "name": "A String", # Name is optionally used to expose a dedicated hostname for referencing this
               # target exclusively.
@@ -169,10 +170,12 @@
               # +optional
         },
       ],
-      "address": { # Information for connecting over HTTP(s). # Similar to domain, information on where the service is available on HTTP.
-        "hostname": "A String",
+      "address": { # Information for connecting over HTTP(s). # Similar to url, information on where the service is available on HTTP.
+        "url": "A String",
+        "hostname": "A String", # Deprecated - use url instead.
       },
-      "domainInternal": "A String", # For Cloud Run, identifical to domain.
+      "domainInternal": "A String", # Deprecated - use address instead.
+          # For Cloud Run, identifical to domain.
       "conditions": [ # Conditions communicates information about ongoing/complete
           # reconciliation processes that bring the "spec" inline with the observed
           # state of the world.
@@ -208,8 +211,6 @@
               # ready Revision of the Configuration should be used for this traffic
               # target. When provided LatestRevision must be true if RevisionName is
               # empty; it must be false when RevisionName is non-empty.
-              #
-              # Not currently supported in Cloud Run.
               # +optional
           "name": "A String", # Name is optionally used to expose a dedicated hostname for referencing this
               # target exclusively.
@@ -247,7 +248,7 @@
         },
       ],
     },
-    "apiVersion": "A String", # The API version for this call such as "v1alpha1".
+    "apiVersion": "A String", # The API version for this call such as "serving.knative.dev/v1alpha1".
     "metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Route, including name, namespace, labels,
         # and annotations.
         # all objects users must create.
@@ -260,8 +261,8 @@
           "kind": "A String", # Kind of the referent.
               # More info:
               # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds
-          "uid": "A String", # UID of the referent.
-              # More info: http://kubernetes.io/docs/user-guide/identifiers#uids
+          "name": "A String", # Name of the referent.
+              # More info: http://kubernetes.io/docs/user-guide/identifiers#names
           "apiVersion": "A String", # API version of the referent.
           "controller": True or False, # If true, this reference points to the managing controller.
               # +optional
@@ -272,8 +273,8 @@
               # To set this field, a user needs "delete" permission of the owner,
               # otherwise 422 (Unprocessable Entity) will be returned.
               # +optional
-          "name": "A String", # Name of the referent.
-              # More info: http://kubernetes.io/docs/user-guide/identifiers#names
+          "uid": "A String", # UID of the referent.
+              # More info: http://kubernetes.io/docs/user-guide/identifiers#uids
         },
       ],
       "name": "A String", # Name must be unique within a namespace, within a Cloud Run region.
@@ -340,29 +341,6 @@
           # +patchStrategy=merge
         "A String",
       ],
-      "initializers": { # Initializers tracks the progress of initialization. # Not currently supported by Cloud Run.
-          #
-          # An initializer is a controller which enforces some system invariant at
-          # object creation time. This field is a list of initializers that have not
-          # yet acted on this object. If nil or empty, this object has been completely
-          # initialized. Otherwise, the object is considered uninitialized and is
-          # hidden (in list/watch and get calls) from clients that haven't explicitly
-          # asked to observe uninitialized objects.
-          #
-          # When an object is created, the system will populate this list with the
-          # current set of initializers. Only privileged users may set or modify this
-          # list. Once it is empty, it may not be modified further by any user.
-        "pending": [ # Pending is a list of initializers that must execute in order before this
-            # object is visible. When the last pending initializer is removed, and no
-            # failing result is set, the initializers struct will be set to nil and the
-            # object is considered as initialized and visible to all clients.
-            # +patchMergeKey=name
-            # +patchStrategy=merge
-          { # Initializer is information about an initializer that has not yet completed.
-            "name": "A String", # name of the process that is responsible for initializing this object.
-          },
-        ],
-      },
       "resourceVersion": "A String", # An opaque value that represents the internal version of this object that
           # can be used by clients to determine when objects have changed. May be used
           # for optimistic concurrency, change detection, and the watch operation on a
@@ -475,9 +453,9 @@
           # automatically deploy the "latest ready" Revision from that Configuration.
         "status": { # RouteStatus communicates the observed state of the Route (from the # Status communicates the observed state of the Route (from the controller).
             # controller).
-          "domain": "A String", # Domain holds the top-level domain that will distribute traffic over the
-              # provided targets. It generally has the form
-              # https://{route-hash}-{project-hash}-{cluster-level-suffix}.a.run.app
+          "domain": "A String", # Deprecated - use url instead.
+              # Domain holds the top-level domain that will distribute traffic over the
+              # provided targets.
           "observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Route that
               # was last processed by the controller.
               #
@@ -489,6 +467,9 @@
               # result in a Route that does not increment either its metadata.generation or
               # its observedGeneration, as new "latest ready" revisions from the
               # Configuration are processed without an update to the Route's spec.
+          "url": "A String", # URL holds the url that will distribute traffic over the provided traffic
+              # targets. It generally has the form
+              # https://{route-hash}-{project-hash}-{cluster-level-suffix}.a.run.app
           "traffic": [ # Traffic holds the configured traffic distribution.
               # These entries will always contain RevisionName references.
               # When ConfigurationName appears in the spec, this will hold the
@@ -498,8 +479,6 @@
                   # ready Revision of the Configuration should be used for this traffic
                   # target. When provided LatestRevision must be true if RevisionName is
                   # empty; it must be false when RevisionName is non-empty.
-                  #
-                  # Not currently supported in Cloud Run.
                   # +optional
               "name": "A String", # Name is optionally used to expose a dedicated hostname for referencing this
                   # target exclusively.
@@ -536,10 +515,12 @@
                   # +optional
             },
           ],
-          "address": { # Information for connecting over HTTP(s). # Similar to domain, information on where the service is available on HTTP.
-            "hostname": "A String",
+          "address": { # Information for connecting over HTTP(s). # Similar to url, information on where the service is available on HTTP.
+            "url": "A String",
+            "hostname": "A String", # Deprecated - use url instead.
           },
-          "domainInternal": "A String", # For Cloud Run, identifical to domain.
+          "domainInternal": "A String", # Deprecated - use address instead.
+              # For Cloud Run, identifical to domain.
           "conditions": [ # Conditions communicates information about ongoing/complete
               # reconciliation processes that bring the "spec" inline with the observed
               # state of the world.
@@ -575,8 +556,6 @@
                   # ready Revision of the Configuration should be used for this traffic
                   # target. When provided LatestRevision must be true if RevisionName is
                   # empty; it must be false when RevisionName is non-empty.
-                  #
-                  # Not currently supported in Cloud Run.
                   # +optional
               "name": "A String", # Name is optionally used to expose a dedicated hostname for referencing this
                   # target exclusively.
@@ -614,7 +593,7 @@
             },
           ],
         },
-        "apiVersion": "A String", # The API version for this call such as "v1alpha1".
+        "apiVersion": "A String", # The API version for this call such as "serving.knative.dev/v1alpha1".
         "metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Route, including name, namespace, labels,
             # and annotations.
             # all objects users must create.
@@ -627,8 +606,8 @@
               "kind": "A String", # Kind of the referent.
                   # More info:
                   # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds
-              "uid": "A String", # UID of the referent.
-                  # More info: http://kubernetes.io/docs/user-guide/identifiers#uids
+              "name": "A String", # Name of the referent.
+                  # More info: http://kubernetes.io/docs/user-guide/identifiers#names
               "apiVersion": "A String", # API version of the referent.
               "controller": True or False, # If true, this reference points to the managing controller.
                   # +optional
@@ -639,8 +618,8 @@
                   # To set this field, a user needs "delete" permission of the owner,
                   # otherwise 422 (Unprocessable Entity) will be returned.
                   # +optional
-              "name": "A String", # Name of the referent.
-                  # More info: http://kubernetes.io/docs/user-guide/identifiers#names
+              "uid": "A String", # UID of the referent.
+                  # More info: http://kubernetes.io/docs/user-guide/identifiers#uids
             },
           ],
           "name": "A String", # Name must be unique within a namespace, within a Cloud Run region.
@@ -707,29 +686,6 @@
               # +patchStrategy=merge
             "A String",
           ],
-          "initializers": { # Initializers tracks the progress of initialization. # Not currently supported by Cloud Run.
-              #
-              # An initializer is a controller which enforces some system invariant at
-              # object creation time. This field is a list of initializers that have not
-              # yet acted on this object. If nil or empty, this object has been completely
-              # initialized. Otherwise, the object is considered uninitialized and is
-              # hidden (in list/watch and get calls) from clients that haven't explicitly
-              # asked to observe uninitialized objects.
-              #
-              # When an object is created, the system will populate this list with the
-              # current set of initializers. Only privileged users may set or modify this
-              # list. Once it is empty, it may not be modified further by any user.
-            "pending": [ # Pending is a list of initializers that must execute in order before this
-                # object is visible. When the last pending initializer is removed, and no
-                # failing result is set, the initializers struct will be set to nil and the
-                # object is considered as initialized and visible to all clients.
-                # +patchMergeKey=name
-                # +patchStrategy=merge
-              { # Initializer is information about an initializer that has not yet completed.
-                "name": "A String", # name of the process that is responsible for initializing this object.
-              },
-            ],
-          },
           "resourceVersion": "A String", # An opaque value that represents the internal version of this object that
               # can be used by clients to determine when objects have changed. May be used
               # for optimistic concurrency, change detection, and the watch operation on a
@@ -797,7 +753,7 @@
         },
       },
     ],
-    "apiVersion": "A String", # The API version for this call such as "v1alpha1".
+    "apiVersion": "A String", # The API version for this call such as "serving.knative.dev/v1alpha1".
     "metadata": { # ListMeta describes metadata that synthetic resources must have, including # Metadata associated with this Route list.
         # lists and various status objects. A resource may have only one of
         # {ObjectMeta, ListMeta}.