diff --git a/google/monitoring/v3/alert.proto b/google/monitoring/v3/alert.proto
index d65e00db..a498ff07 100644
--- a/google/monitoring/v3/alert.proto
+++ b/google/monitoring/v3/alert.proto
@@ -89,7 +89,7 @@ message AlertPolicy {
     // A condition type that compares a collection of time series
     // against a threshold.
     message MetricThreshold {
-      // A [filter](/monitoring/api/v3/filters) that
+      // A [filter](https://cloud.google.com/monitoring/api/v3/filters) that
       // identifies which time series should be compared with the threshold.
       //
       // The filter is similar to the one that is specified in the
@@ -114,11 +114,11 @@ message AlertPolicy {
       // field.
       repeated Aggregation aggregations = 8;
 
-      // A [filter](/monitoring/api/v3/filters) that identifies a time
-      // series that should be used as the denominator of a ratio that will be
-      // compared with the threshold. If a `denominator_filter` is specified,
-      // the time series specified by the `filter` field will be used as the
-      // numerator.
+      // A [filter](https://cloud.google.com/monitoring/api/v3/filters) that
+      // identifies a time series that should be used as the denominator of a
+      // ratio that will be compared with the threshold. If a
+      // `denominator_filter` is specified, the time series specified by the
+      // `filter` field will be used as the numerator.
       //
       // The filter must specify the metric type and optionally may contain
       // restrictions on resource type, resource labels, and metric labels.
@@ -175,7 +175,7 @@ message AlertPolicy {
     // when a time series for the specified metric of a monitored
     // resource does not include any data in the specified `duration`.
     message MetricAbsence {
-      // A [filter](/monitoring/api/v3/filters) that
+      // A [filter](https://cloud.google.com/monitoring/api/v3/filters) that
       // identifies which time series should be compared with the threshold.
       //
       // The filter is similar to the one that is specified in the
@@ -216,9 +216,9 @@ message AlertPolicy {
     }
 
     // Required if the condition exists. The unique resource name for this
-    // condition. Its syntax is:
+    // condition. Its format is:
     //
-    //     projects/[PROJECT_ID]/alertPolicies/[POLICY_ID]/conditions/[CONDITION_ID]
+    //     projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[POLICY_ID]/conditions/[CONDITION_ID]
     //
     // `[CONDITION_ID]` is assigned by Stackdriver Monitoring when the
     // condition is created as part of a new or updated alerting policy.
@@ -264,7 +264,7 @@ message AlertPolicy {
     COMBINE_UNSPECIFIED = 0;
 
     // Combine conditions using the logical `AND` operator. An
-    // incident is created only if all conditions are met
+    // incident is created only if all the conditions are met
     // simultaneously. This combiner is satisfied if all conditions are
     // met, even if they are met on completely different resources.
     AND = 1;
@@ -280,9 +280,9 @@ message AlertPolicy {
   }
 
   // Required if the policy exists. The resource name for this policy. The
-  // syntax is:
+  // format is:
   //
-  //     projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
+  //     projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]
   //
   // `[ALERT_POLICY_ID]` is assigned by Stackdriver Monitoring when the policy
   // is created.  When calling the
@@ -317,14 +317,14 @@ message AlertPolicy {
   // OR according to the `combiner` field. If the combined conditions evaluate
   // to true, then an incident is created. A policy can have from one to six
   // conditions.
-  // If |condition_time_series_uery_language| is present, it must be the only
-  // |condition|.
+  // If `condition_time_series_query_language` is present, it must be the only
+  // `condition`.
   repeated Condition conditions = 12;
 
   // How to combine the results of multiple conditions to determine if an
   // incident should be opened.
-  // If condition_time_series_query_language is present, this must be
-  // COMBINE_UNSPECIFIED.
+  // If `condition_time_series_query_language` is present, this must be
+  // `COMBINE_UNSPECIFIED`.
   ConditionCombinerType combiner = 6;
 
   // Whether or not the policy is enabled. On write, the default interpretation
@@ -345,9 +345,9 @@ message AlertPolicy {
   // [`NotificationChannel`][google.monitoring.v3.NotificationChannel]
   // objects that are returned from the [`ListNotificationChannels`]
   // [google.monitoring.v3.NotificationChannelService.ListNotificationChannels]
-  // method. The syntax of the entries in this field is:
+  // method. The format of the entries in this field is:
   //
-  //     projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]
+  //     projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]
   repeated string notification_channels = 14;
 
   // A read-only record of the creation of the alerting policy. If provided
diff --git a/google/monitoring/v3/alert_service.proto b/google/monitoring/v3/alert_service.proto
index a88c376f..8115b387 100644
--- a/google/monitoring/v3/alert_service.proto
+++ b/google/monitoring/v3/alert_service.proto
@@ -96,14 +96,16 @@ service AlertPolicyService {
 
 // The protocol for the `CreateAlertPolicy` request.
 message CreateAlertPolicyRequest {
-  // Required. The project in which to create the alerting policy. The format is
-  // `projects/[PROJECT_ID]`.
+  // Required. The project in which to create the alerting policy. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
   //
   // Note that this field names the parent container in which the alerting
   // policy will be written, not the name of the created policy. The alerting
   // policy that is returned will have a name that contains a normalized
   // representation of this name as a prefix but adds a suffix of the form
-  // `/alertPolicies/[POLICY_ID]`, identifying the policy in the container.
+  // `/alertPolicies/[ALERT_POLICY_ID]`, identifying the policy in the
+  // container.
   string name = 3 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -113,15 +115,15 @@ message CreateAlertPolicyRequest {
 
   // Required. The requested alerting policy. You should omit the `name` field in this
   // policy. The name will be returned in the new policy, including
-  // a new [ALERT_POLICY_ID] value.
+  // a new `[ALERT_POLICY_ID]` value.
   AlertPolicy alert_policy = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The protocol for the `GetAlertPolicy` request.
 message GetAlertPolicyRequest {
-  // Required. The alerting policy to retrieve. The format is
+  // Required. The alerting policy to retrieve. The format is:
   //
-  //     projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
+  //     projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]
   string name = 3 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -132,9 +134,9 @@ message GetAlertPolicyRequest {
 
 // The protocol for the `ListAlertPolicies` request.
 message ListAlertPoliciesRequest {
-  // Required. The project whose alert policies are to be listed. The format is
+  // Required. The project whose alert policies are to be listed. The format is:
   //
-  //     projects/[PROJECT_ID]
+  //     projects/[PROJECT_ID_OR_NUMBER]
   //
   // Note that this field names the parent container in which the alerting
   // policies to be listed are stored. To retrieve a single alerting policy
@@ -152,7 +154,7 @@ message ListAlertPoliciesRequest {
   // alert policies to be included in the response.
   //
   // For more details, see [sorting and
-  // filtering](/monitoring/api/v3/sorting-and-filtering).
+  // filtering](https://cloud.google.com/monitoring/api/v3/sorting-and-filtering).
   string filter = 5;
 
   // A comma-separated list of fields by which to sort the result. Supports
@@ -160,7 +162,7 @@ message ListAlertPoliciesRequest {
   // prefixed with a minus sign to sort by the field in descending order.
   //
   // For more details, see [sorting and
-  // filtering](/monitoring/api/v3/sorting-and-filtering).
+  // filtering](https://cloud.google.com/monitoring/api/v3/sorting-and-filtering).
   string order_by = 6;
 
   // The maximum number of results to return in a single response.
@@ -179,7 +181,7 @@ message ListAlertPoliciesResponse {
 
   // If there might be more results than were returned, then this field is set
   // to a non-empty value. To see the additional results,
-  // use that value as `pageToken` in the next call to this method.
+  // use that value as `page_token` in the next call to this method.
   string next_page_token = 2;
 }
 
@@ -219,7 +221,7 @@ message UpdateAlertPolicyRequest {
 message DeleteAlertPolicyRequest {
   // Required. The alerting policy to delete. The format is:
   //
-  //     projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]
+  //     projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]
   //
   // For more information, see [AlertPolicy][google.monitoring.v3.AlertPolicy].
   string name = 3 [
diff --git a/google/monitoring/v3/group_service.proto b/google/monitoring/v3/group_service.proto
index 5647dcfb..39b80512 100644
--- a/google/monitoring/v3/group_service.proto
+++ b/google/monitoring/v3/group_service.proto
@@ -106,8 +106,9 @@ service GroupService {
 
 // The `ListGroup` request.
 message ListGroupsRequest {
-  // Required. The project whose groups are to be listed. The format is
-  // `"projects/{project_id_or_number}"`.
+  // Required. The project whose groups are to be listed. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
   string name = 7 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -119,14 +120,20 @@ message ListGroupsRequest {
   // the groups returned based on their parent-child relationship with the
   // specified group. If no filter is specified, all groups are returned.
   oneof filter {
-    // A group name: `"projects/{project_id_or_number}/groups/{group_id}"`.
-    // Returns groups whose `parentName` field contains the group
+    // A group name. The format is:
+    //
+    //     projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
+    //
+    // Returns groups whose `parent_name` field contains the group
     // name.  If no groups have this parent, the results are empty.
     string children_of_group = 2 [(google.api.resource_reference) = {
                                     type: "monitoring.googleapis.com/Group"
                                   }];
 
-    // A group name: `"projects/{project_id_or_number}/groups/{group_id}"`.
+    // A group name. The format is:
+    //
+    //     projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
+    //
     // Returns groups that are ancestors of the specified group.
     // The groups are returned in order, starting with the immediate parent and
     // ending with the most distant ancestor.  If the specified group has no
@@ -135,9 +142,12 @@ message ListGroupsRequest {
                                      type: "monitoring.googleapis.com/Group"
                                    }];
 
-    // A group name: `"projects/{project_id_or_number}/groups/{group_id}"`.
+    // A group name. The format is:
+    //
+    //     projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
+    //
     // Returns the descendants of the specified group.  This is a superset of
-    // the results returned by the `childrenOfGroup` filter, and includes
+    // the results returned by the `children_of_group` filter, and includes
     // children-of-children, and so forth.
     string descendants_of_group = 4 [(google.api.resource_reference) = {
                                        type: "monitoring.googleapis.com/Group"
@@ -147,7 +157,7 @@ message ListGroupsRequest {
   // A positive number that is the maximum number of results to return.
   int32 page_size = 5;
 
-  // If this field is not empty then it must contain the `nextPageToken` value
+  // If this field is not empty then it must contain the `next_page_token` value
   // returned by a previous call to this method.  Using this field causes the
   // method to return additional results from the previous method call.
   string page_token = 6;
@@ -160,14 +170,15 @@ message ListGroupsResponse {
 
   // If there are more results than have been returned, then this field is set
   // to a non-empty value.  To see the additional results,
-  // use that value as `pageToken` in the next call to this method.
+  // use that value as `page_token` in the next call to this method.
   string next_page_token = 2;
 }
 
 // The `GetGroup` request.
 message GetGroupRequest {
-  // Required. The group to retrieve. The format is
-  // `"projects/{project_id_or_number}/groups/{group_id}"`.
+  // Required. The group to retrieve. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
   string name = 3 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -178,8 +189,9 @@ message GetGroupRequest {
 
 // The `CreateGroup` request.
 message CreateGroupRequest {
-  // Required. The project in which to create the group. The format is
-  // `"projects/{project_id_or_number}"`.
+  // Required. The project in which to create the group. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
   string name = 4 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -208,8 +220,9 @@ message UpdateGroupRequest {
 // The `DeleteGroup` request. The default behavior is to be able to delete a
 // single group without any descendants.
 message DeleteGroupRequest {
-  // Required. The group to delete. The format is
-  // `"projects/{project_id_or_number}/groups/{group_id}"`.
+  // Required. The group to delete. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
   string name = 3 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -225,8 +238,9 @@ message DeleteGroupRequest {
 
 // The `ListGroupMembers` request.
 message ListGroupMembersRequest {
-  // Required. The group whose members are listed. The format is
-  // `"projects/{project_id_or_number}/groups/{group_id}"`.
+  // Required. The group whose members are listed. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/groups/[GROUP_ID]
   string name = 7 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -237,18 +251,19 @@ message ListGroupMembersRequest {
   // A positive number that is the maximum number of results to return.
   int32 page_size = 3;
 
-  // If this field is not empty then it must contain the `nextPageToken` value
+  // If this field is not empty then it must contain the `next_page_token` value
   // returned by a previous call to this method.  Using this field causes the
   // method to return additional results from the previous method call.
   string page_token = 4;
 
-  // An optional [list filter](/monitoring/api/learn_more#filtering) describing
-  // the members to be returned.  The filter may reference the type, labels, and
-  // metadata of monitored resources that comprise the group.
-  // For example, to return only resources representing Compute Engine VM
-  // instances, use this filter:
+  // An optional [list
+  // filter](https://cloud.google.com/monitoring/api/learn_more#filtering)
+  // describing the members to be returned.  The filter may reference the type,
+  // labels, and metadata of monitored resources that comprise the group. For
+  // example, to return only resources representing Compute Engine VM instances,
+  // use this filter:
   //
-  //     resource.type = "gce_instance"
+  //     `resource.type = "gce_instance"`
   string filter = 5;
 
   // An optional time interval for which results should be returned. Only
@@ -265,7 +280,7 @@ message ListGroupMembersResponse {
 
   // If there are more results than have been returned, then this field is
   // set to a non-empty value.  To see the additional results, use that value as
-  // `pageToken` in the next call to this method.
+  // `page_token` in the next call to this method.
   string next_page_token = 2;
 
   // The total number of elements matching this request.
diff --git a/google/monitoring/v3/metric_service.proto b/google/monitoring/v3/metric_service.proto
index a788cc16..56263d12 100644
--- a/google/monitoring/v3/metric_service.proto
+++ b/google/monitoring/v3/metric_service.proto
@@ -97,7 +97,7 @@ service MetricService {
 
   // Creates a new metric descriptor.
   // User-created metric descriptors define
-  // [custom metrics](/monitoring/custom-metrics).
+  // [custom metrics](https://cloud.google.com/monitoring/custom-metrics).
   rpc CreateMetricDescriptor(CreateMetricDescriptorRequest) returns (google.api.MetricDescriptor) {
     option (google.api.http) = {
       post: "/v3/{name=projects/*}/metricDescriptors"
@@ -107,7 +107,8 @@ service MetricService {
   }
 
   // Deletes a metric descriptor. Only user-created
-  // [custom metrics](/monitoring/custom-metrics) can be deleted.
+  // [custom metrics](https://cloud.google.com/monitoring/custom-metrics) can be
+  // deleted.
   rpc DeleteMetricDescriptor(DeleteMetricDescriptorRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/v3/{name=projects/*/metricDescriptors/**}"
@@ -138,8 +139,9 @@ service MetricService {
 
 // The `ListMonitoredResourceDescriptors` request.
 message ListMonitoredResourceDescriptorsRequest {
-  // Required. The project on which to execute the request. The format is
-  // `"projects/{project_id_or_number}"`.
+  // Required. The project on which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
   string name = 5 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -147,11 +149,10 @@ message ListMonitoredResourceDescriptorsRequest {
     }
   ];
 
-  // An optional [filter](/monitoring/api/v3/filters) describing
-  // the descriptors to be returned.  The filter can reference
-  // the descriptor's type and labels. For example, the
-  // following filter returns only Google Compute Engine descriptors
-  // that have an `id` label:
+  // An optional [filter](https://cloud.google.com/monitoring/api/v3/filters)
+  // describing the descriptors to be returned.  The filter can reference the
+  // descriptor's type and labels. For example, the following filter returns
+  // only Google Compute Engine descriptors that have an `id` label:
   //
   //     resource.type = starts_with("gce_") AND resource.label:id
   string filter = 2;
@@ -173,15 +174,17 @@ message ListMonitoredResourceDescriptorsResponse {
 
   // If there are more results than have been returned, then this field is set
   // to a non-empty value.  To see the additional results,
-  // use that value as `pageToken` in the next call to this method.
+  // use that value as `page_token` in the next call to this method.
   string next_page_token = 2;
 }
 
 // The `GetMonitoredResourceDescriptor` request.
 message GetMonitoredResourceDescriptorRequest {
-  // Required. The monitored resource descriptor to get.  The format is
-  // `"projects/{project_id_or_number}/monitoredResourceDescriptors/{resource_type}"`.
-  // The `{resource_type}` is a predefined type, such as
+  // Required. The monitored resource descriptor to get.  The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/monitoredResourceDescriptors/[RESOURCE_TYPE]
+  //
+  // The `[RESOURCE_TYPE]` is a predefined type, such as
   // `cloudsql_database`.
   string name = 3 [
     (google.api.field_behavior) = REQUIRED,
@@ -193,8 +196,9 @@ message GetMonitoredResourceDescriptorRequest {
 
 // The `ListMetricDescriptors` request.
 message ListMetricDescriptorsRequest {
-  // Required. The project on which to execute the request. The format is
-  // `"projects/{project_id_or_number}"`.
+  // Required. The project on which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
   string name = 5 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -204,10 +208,10 @@ message ListMetricDescriptorsRequest {
 
   // If this field is empty, all custom and
   // system-defined metric descriptors are returned.
-  // Otherwise, the [filter](/monitoring/api/v3/filters)
+  // Otherwise, the [filter](https://cloud.google.com/monitoring/api/v3/filters)
   // specifies which metric descriptors are to be
   // returned. For example, the following filter matches all
-  // [custom metrics](/monitoring/custom-metrics):
+  // [custom metrics](https://cloud.google.com/monitoring/custom-metrics):
   //
   //     metric.type = starts_with("custom.googleapis.com/")
   string filter = 2;
@@ -229,15 +233,17 @@ message ListMetricDescriptorsResponse {
 
   // If there are more results than have been returned, then this field is set
   // to a non-empty value.  To see the additional results,
-  // use that value as `pageToken` in the next call to this method.
+  // use that value as `page_token` in the next call to this method.
   string next_page_token = 2;
 }
 
 // The `GetMetricDescriptor` request.
 message GetMetricDescriptorRequest {
-  // Required. The metric descriptor on which to execute the request. The format is
-  // `"projects/{project_id_or_number}/metricDescriptors/{metric_id}"`.
-  // An example value of `{metric_id}` is
+  // Required. The metric descriptor on which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/metricDescriptors/[METRIC_ID]
+  //
+  // An example value of `[METRIC_ID]` is
   // `"compute.googleapis.com/instance/disk/read_bytes_count"`.
   string name = 3 [
     (google.api.field_behavior) = REQUIRED,
@@ -249,8 +255,9 @@ message GetMetricDescriptorRequest {
 
 // The `CreateMetricDescriptor` request.
 message CreateMetricDescriptorRequest {
-  // Required. The project on which to execute the request. The format is
-  // `"projects/{project_id_or_number}"`.
+  // Required. The project on which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
   string name = 3 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -258,16 +265,18 @@ message CreateMetricDescriptorRequest {
     }
   ];
 
-  // Required. The new [custom metric](/monitoring/custom-metrics)
+  // Required. The new [custom metric](https://cloud.google.com/monitoring/custom-metrics)
   // descriptor.
   google.api.MetricDescriptor metric_descriptor = 2 [(google.api.field_behavior) = REQUIRED];
 }
 
 // The `DeleteMetricDescriptor` request.
 message DeleteMetricDescriptorRequest {
-  // Required. The metric descriptor on which to execute the request. The format is
-  // `"projects/{project_id_or_number}/metricDescriptors/{metric_id}"`.
-  // An example of `{metric_id}` is:
+  // Required. The metric descriptor on which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/metricDescriptors/[METRIC_ID]
+  //
+  // An example of `[METRIC_ID]` is:
   // `"custom.googleapis.com/my_test_metric"`.
   string name = 3 [
     (google.api.field_behavior) = REQUIRED,
@@ -290,18 +299,20 @@ message ListTimeSeriesRequest {
     HEADERS = 1;
   }
 
-  // Required. The project on which to execute the request. The format is
-  // "projects/{project_id_or_number}".
+  // Required. The project on which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
   string name = 10 [
     (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference).type =
-        "cloudresourcemanager.googleapis.com/Project"
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
   ];
 
-  // Required. A [monitoring filter](/monitoring/api/v3/filters) that specifies which time
-  // series should be returned.  The filter must specify a single metric type,
-  // and can additionally specify metric labels and other information. For
-  // example:
+  // Required. A [monitoring filter](https://cloud.google.com/monitoring/api/v3/filters)
+  // that specifies which time series should be returned.  The filter must
+  // specify a single metric type, and can additionally specify metric labels
+  // and other information. For example:
   //
   //     metric.type = "compute.googleapis.com/instance/cpu/usage_time" AND
   //         metric.labels.instance_name = "my-instance-name"
@@ -346,7 +357,7 @@ message ListTimeSeriesResponse {
 
   // If there are more results than have been returned, then this field is set
   // to a non-empty value.  To see the additional results,
-  // use that value as `pageToken` in the next call to this method.
+  // use that value as `page_token` in the next call to this method.
   string next_page_token = 2;
 
   // Query execution errors that may have caused the time series data returned
@@ -356,12 +367,14 @@ message ListTimeSeriesResponse {
 
 // The `CreateTimeSeries` request.
 message CreateTimeSeriesRequest {
-  // Required. The project on which to execute the request. The format is
-  // `"projects/{project_id_or_number}"`.
+  // Required. The project on which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
   string name = 3 [
     (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference).type =
-        "cloudresourcemanager.googleapis.com/Project"
+    (google.api.resource_reference) = {
+      type: "cloudresourcemanager.googleapis.com/Project"
+    }
   ];
 
   // Required. The new data to be added to a list of time series.
diff --git a/google/monitoring/v3/notification_service.proto b/google/monitoring/v3/notification_service.proto
index 959cc049..2ba8ae29 100644
--- a/google/monitoring/v3/notification_service.proto
+++ b/google/monitoring/v3/notification_service.proto
@@ -165,7 +165,7 @@ message ListNotificationChannelDescriptorsRequest {
   // Required. The REST resource name of the parent from which to retrieve
   // the notification channel descriptors. The expected syntax is:
   //
-  //     projects/[PROJECT_ID]
+  //     projects/[PROJECT_ID_OR_NUMBER]
   //
   // Note that this names the parent container in which to look for the
   // descriptors; to retrieve a single descriptor by name, use the
@@ -204,8 +204,9 @@ message ListNotificationChannelDescriptorsResponse {
 
 // The `GetNotificationChannelDescriptor` response.
 message GetNotificationChannelDescriptorRequest {
-  // Required. The channel type for which to execute the request. The format is
-  // `projects/[PROJECT_ID]/notificationChannelDescriptors/{channel_type}`.
+  // Required. The channel type for which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/notificationChannelDescriptors/[CHANNEL_TYPE]
   string name = 3 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -218,10 +219,10 @@ message GetNotificationChannelDescriptorRequest {
 message CreateNotificationChannelRequest {
   // Required. The project on which to execute the request. The format is:
   //
-  //     projects/[PROJECT_ID]
+  //     projects/[PROJECT_ID_OR_NUMBER]
   //
-  // Note that this names the container into which the channel will be
-  // written. This does not name the newly created channel. The resulting
+  // This names the container into which the channel will be
+  // written, this does not name the newly created channel. The resulting
   // channel's name will have a normalized version of this field as a prefix,
   // but will add `/notificationChannels/[CHANNEL_ID]` to identify the channel.
   string name = 3 [
@@ -237,8 +238,11 @@ message CreateNotificationChannelRequest {
 
 // The `ListNotificationChannels` request.
 message ListNotificationChannelsRequest {
-  // Required. The project on which to execute the request. The format is
-  // `projects/[PROJECT_ID]`. That is, this names the container
+  // Required. The project on which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]
+  //
+  // This names the container
   // in which to look for the notification channels; it does not name a
   // specific channel. To query a specific channel by REST resource name, use
   // the
@@ -255,7 +259,7 @@ message ListNotificationChannelsRequest {
   // notification channels to be included in the response.
   //
   // For more details, see [sorting and
-  // filtering](/monitoring/api/v3/sorting-and-filtering).
+  // filtering](https://cloud.google.com/monitoring/api/v3/sorting-and-filtering).
   string filter = 6;
 
   // A comma-separated list of fields by which to sort the result. Supports
@@ -263,7 +267,7 @@ message ListNotificationChannelsRequest {
   // a minus sign to sort in descending rather than ascending order.
   //
   // For more details, see [sorting and
-  // filtering](/monitoring/api/v3/sorting-and-filtering).
+  // filtering](https://cloud.google.com/monitoring/api/v3/sorting-and-filtering).
   string order_by = 7;
 
   // The maximum number of results to return in a single response. If
@@ -291,8 +295,9 @@ message ListNotificationChannelsResponse {
 
 // The `GetNotificationChannel` request.
 message GetNotificationChannelRequest {
-  // Required. The channel for which to execute the request. The format is
-  // `projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]`.
+  // Required. The channel for which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]
   string name = 3 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
@@ -315,8 +320,9 @@ message UpdateNotificationChannelRequest {
 
 // The `DeleteNotificationChannel` request.
 message DeleteNotificationChannelRequest {
-  // Required. The channel for which to execute the request. The format is
-  // `projects/[PROJECT_ID]/notificationChannels/[CHANNEL_ID]`.
+  // Required. The channel for which to execute the request. The format is:
+  //
+  //     projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]
   string name = 3 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {