docs: Formatting change from HTML to markdown; Additional clarificati…

…ons (#666) - [ ] Regenerate this pull request now. PiperOrigin-RevId: 427761663 Source-Link: googleapis/googleapis@46c5d65 Source-Link: googleapis/googleapis-gen@f86bdde Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZjg2YmRkZTI5ZGI1MzAzNzI4OWFjMmRhYTIwNDc3NzlkODkxZDM0ZSJ9
googleapis · Feb 11, 2022 · 008f532 · 008f532
1 parent 8c25c84
commit 008f532
Show file tree

Hide file tree

Showing 17 changed files with 775 additions and 712 deletions.
diff --git a/...ngbudgets/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetServiceClient.java b/...ngbudgets/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetServiceClient.java
@@ -155,8 +155,8 @@ public BudgetServiceStub getStub() {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Creates a new budget. See &lt;a href="https://cloud.google.com/billing/quotas"&gt;Quotas and
-   * limits&lt;/a&gt; for more information on the limits of the number of budgets you can create.
+   * Creates a new budget. See [Quotas and limits](https://cloud.google.com/billing/quotas) for more
+   * information on the limits of the number of budgets you can create.
    *
    * <p>Sample code:
    *
@@ -180,8 +180,8 @@ public final Budget createBudget(CreateBudgetRequest request) {
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Creates a new budget. See &lt;a href="https://cloud.google.com/billing/quotas"&gt;Quotas and
-   * limits&lt;/a&gt; for more information on the limits of the number of budgets you can create.
+   * Creates a new budget. See [Quotas and limits](https://cloud.google.com/billing/quotas) for more
+   * information on the limits of the number of budgets you can create.
    *
    * <p>Sample code:
    *

diff --git a/...ets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetServiceGrpc.java b/...ets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/BudgetServiceGrpc.java
@@ -318,7 +318,7 @@ public abstract static class BudgetServiceImplBase implements io.grpc.BindableSe
      *
      * <pre>
      * Creates a new budget. See
-     * &lt;a href="https://cloud.google.com/billing/quotas"&gt;Quotas and limits&lt;/a&gt;
+     * [Quotas and limits](https://cloud.google.com/billing/quotas)
      * for more information on the limits of the number of budgets you can create.
      * </pre>
      */
@@ -463,7 +463,7 @@ protected BudgetServiceStub build(io.grpc.Channel channel, io.grpc.CallOptions c
      *
      * <pre>
      * Creates a new budget. See
-     * &lt;a href="https://cloud.google.com/billing/quotas"&gt;Quotas and limits&lt;/a&gt;
+     * [Quotas and limits](https://cloud.google.com/billing/quotas)
      * for more information on the limits of the number of budgets you can create.
      * </pre>
      */
@@ -579,7 +579,7 @@ protected BudgetServiceBlockingStub build(
      *
      * <pre>
      * Creates a new budget. See
-     * &lt;a href="https://cloud.google.com/billing/quotas"&gt;Quotas and limits&lt;/a&gt;
+     * [Quotas and limits](https://cloud.google.com/billing/quotas)
      * for more information on the limits of the number of budgets you can create.
      * </pre>
      */
@@ -678,7 +678,7 @@ protected BudgetServiceFutureStub build(
      *
      * <pre>
      * Creates a new budget. See
-     * &lt;a href="https://cloud.google.com/billing/quotas"&gt;Quotas and limits&lt;/a&gt;
+     * [Quotas and limits](https://cloud.google.com/billing/quotas)
      * for more information on the limits of the number of budgets you can create.
      * </pre>
      */

diff --git a/...udgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/AllUpdatesRule.java b/...udgets-v1beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/AllUpdatesRule.java
diff --git a/...beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/AllUpdatesRuleOrBuilder.java b/...beta1/src/main/java/com/google/cloud/billing/budgets/v1beta1/AllUpdatesRuleOrBuilder.java
@@ -27,10 +27,10 @@ public interface AllUpdatesRuleOrBuilder
    *
    *
    * <pre>
-   * Optional. The name of the Pub/Sub topic where budget related messages will
-   * be published, in the form `projects/{project_id}/topics/{topic_id}`.
-   * Updates are sent at regular intervals to the topic. The topic needs to be
-   * created before the budget is created; see
+   * Optional. The name of the Pub/Sub topic where budget related messages will be
+   * published, in the form `projects/{project_id}/topics/{topic_id}`. Updates
+   * are sent at regular intervals to the topic.
+   * The topic needs to be created before the budget is created; see
    * https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications
    * for more details.
    * Caller is expected to have
@@ -49,10 +49,10 @@ public interface AllUpdatesRuleOrBuilder
    *
    *
    * <pre>
-   * Optional. The name of the Pub/Sub topic where budget related messages will
-   * be published, in the form `projects/{project_id}/topics/{topic_id}`.
-   * Updates are sent at regular intervals to the topic. The topic needs to be
-   * created before the budget is created; see
+   * Optional. The name of the Pub/Sub topic where budget related messages will be
+   * published, in the form `projects/{project_id}/topics/{topic_id}`. Updates
+   * are sent at regular intervals to the topic.
+   * The topic needs to be created before the budget is created; see
    * https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications
    * for more details.
    * Caller is expected to have
@@ -72,11 +72,9 @@ public interface AllUpdatesRuleOrBuilder
    *
    *
    * <pre>
-   * Optional. Required when
-   * [AllUpdatesRule.pubsub_topic][google.cloud.billing.budgets.v1beta1.AllUpdatesRule.pubsub_topic]
-   * is set. The schema version of the notification sent to
-   * [AllUpdatesRule.pubsub_topic][google.cloud.billing.budgets.v1beta1.AllUpdatesRule.pubsub_topic].
-   * Only "1.0" is accepted. It represents the JSON schema as defined in
+   * Optional. Required when [AllUpdatesRule.pubsub_topic][google.cloud.billing.budgets.v1beta1.AllUpdatesRule.pubsub_topic] is set. The schema version of
+   * the notification sent to [AllUpdatesRule.pubsub_topic][google.cloud.billing.budgets.v1beta1.AllUpdatesRule.pubsub_topic]. Only "1.0" is
+   * accepted. It represents the JSON schema as defined in
    * https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#notification_format.
    * </pre>
    *
@@ -89,11 +87,9 @@ public interface AllUpdatesRuleOrBuilder
    *
    *
    * <pre>
-   * Optional. Required when
-   * [AllUpdatesRule.pubsub_topic][google.cloud.billing.budgets.v1beta1.AllUpdatesRule.pubsub_topic]
-   * is set. The schema version of the notification sent to
-   * [AllUpdatesRule.pubsub_topic][google.cloud.billing.budgets.v1beta1.AllUpdatesRule.pubsub_topic].
-   * Only "1.0" is accepted. It represents the JSON schema as defined in
+   * Optional. Required when [AllUpdatesRule.pubsub_topic][google.cloud.billing.budgets.v1beta1.AllUpdatesRule.pubsub_topic] is set. The schema version of
+   * the notification sent to [AllUpdatesRule.pubsub_topic][google.cloud.billing.budgets.v1beta1.AllUpdatesRule.pubsub_topic]. Only "1.0" is
+   * accepted. It represents the JSON schema as defined in
    * https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#notification_format.
    * </pre>
    *
@@ -107,10 +103,10 @@ public interface AllUpdatesRuleOrBuilder
    *
    *
    * <pre>
-   * Optional. Targets to send notifications to when a threshold is exceeded.
-   * This is in addition to default recipients who have billing account IAM
-   * roles. The value is the full REST resource name of a monitoring
-   * notification channel with the form
+   * Optional. Targets to send notifications to when a threshold is exceeded. This is in
+   * addition to default recipients who have billing account IAM roles.
+   * The value is the full REST resource name of a monitoring notification
+   * channel with the form
    * `projects/{project_id}/notificationChannels/{channel_id}`. A maximum of 5
    * channels are allowed. See
    * https://cloud.google.com/billing/docs/how-to/budgets-notification-recipients
@@ -128,10 +124,10 @@ public interface AllUpdatesRuleOrBuilder
    *
    *
    * <pre>
-   * Optional. Targets to send notifications to when a threshold is exceeded.
-   * This is in addition to default recipients who have billing account IAM
-   * roles. The value is the full REST resource name of a monitoring
-   * notification channel with the form
+   * Optional. Targets to send notifications to when a threshold is exceeded. This is in
+   * addition to default recipients who have billing account IAM roles.
+   * The value is the full REST resource name of a monitoring notification
+   * channel with the form
    * `projects/{project_id}/notificationChannels/{channel_id}`. A maximum of 5
    * channels are allowed. See
    * https://cloud.google.com/billing/docs/how-to/budgets-notification-recipients
@@ -149,10 +145,10 @@ public interface AllUpdatesRuleOrBuilder
    *
    *
    * <pre>
-   * Optional. Targets to send notifications to when a threshold is exceeded.
-   * This is in addition to default recipients who have billing account IAM
-   * roles. The value is the full REST resource name of a monitoring
-   * notification channel with the form
+   * Optional. Targets to send notifications to when a threshold is exceeded. This is in
+   * addition to default recipients who have billing account IAM roles.
+   * The value is the full REST resource name of a monitoring notification
+   * channel with the form
    * `projects/{project_id}/notificationChannels/{channel_id}`. A maximum of 5
    * channels are allowed. See
    * https://cloud.google.com/billing/docs/how-to/budgets-notification-recipients
@@ -171,10 +167,10 @@ public interface AllUpdatesRuleOrBuilder
    *
    *
    * <pre>
-   * Optional. Targets to send notifications to when a threshold is exceeded.
-   * This is in addition to default recipients who have billing account IAM
-   * roles. The value is the full REST resource name of a monitoring
-   * notification channel with the form
+   * Optional. Targets to send notifications to when a threshold is exceeded. This is in
+   * addition to default recipients who have billing account IAM roles.
+   * The value is the full REST resource name of a monitoring notification
+   * channel with the form
    * `projects/{project_id}/notificationChannels/{channel_id}`. A maximum of 5
    * channels are allowed. See
    * https://cloud.google.com/billing/docs/how-to/budgets-notification-recipients
@@ -194,10 +190,9 @@ public interface AllUpdatesRuleOrBuilder
    *
    *
    * <pre>
-   * Optional. When set to true, disables default notifications sent when a
-   * threshold is exceeded. Default notifications are sent to those with Billing
-   * Account Administrator and Billing Account User IAM roles for the target
-   * account.
+   * Optional. When set to true, disables default notifications sent when a threshold is
+   * exceeded. Default notifications are sent to those with Billing Account
+   * Administrator and Billing Account User IAM roles for the target account.
    * </pre>
    *
    * <code>bool disable_default_iam_recipients = 4 [(.google.api.field_behavior) = OPTIONAL];</code>