From e062bd9022563c052434d1ecab0a74c57a2b8b9c Mon Sep 17 00:00:00 2001 From: yoshi-automation Date: Thu, 4 Jun 2020 15:59:29 -0700 Subject: [PATCH] docs: fix several broken links in the docs. PiperOrigin-RevId: 314787285 Source-Author: Google APIs Source-Date: Thu Jun 4 13:00:20 2020 -0700 Source-Repo: googleapis/googleapis Source-Sha: 8f41c697c67d357665ce9afac18793c8f80ac73c Source-Link: https://github.com/googleapis/googleapis/commit/8f41c697c67d357665ce9afac18793c8f80ac73c --- .../v1beta1/ErrorGroupServiceClient.java | 22 +++-- .../v1beta1/GetGroupRequest.java | 84 ++++++++----------- .../v1beta1/GetGroupRequestOrBuilder.java | 24 +++--- .../v1beta1/TrackingIssue.java | 14 ++-- .../v1beta1/TrackingIssueOrBuilder.java | 4 +- .../clouderrorreporting/v1beta1/common.proto | 2 +- .../v1beta1/error_group_service.proto | 12 ++- synth.metadata | 6 +- 8 files changed, 73 insertions(+), 95 deletions(-) diff --git a/google-cloud-errorreporting/src/main/java/com/google/cloud/errorreporting/v1beta1/ErrorGroupServiceClient.java b/google-cloud-errorreporting/src/main/java/com/google/cloud/errorreporting/v1beta1/ErrorGroupServiceClient.java index 7820b399..68cc9dcd 100644 --- a/google-cloud-errorreporting/src/main/java/com/google/cloud/errorreporting/v1beta1/ErrorGroupServiceClient.java +++ b/google-cloud-errorreporting/src/main/java/com/google/cloud/errorreporting/v1beta1/ErrorGroupServiceClient.java @@ -261,12 +261,11 @@ public final UnaryCallable updateGroupCallable() * } * * - * @param groupName Required. The group resource name. Written as - * <code>projects/<var>projectID</var>/groups/<var>group_name</var></code>. - * Call <a href="/https/patch-diff.githubusercontent.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list"> - * <code>groupStats.list</code></a> to return a list of groups belonging to - * this project. - *

Example: <code>projects/my-project-123/groups/my-group</code> + * @param groupName The group resource name. Written as + * `projects/{projectID}/groups/{group_name}`. Call + * [`groupStats.list`](https://cloud.google.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list) + * to return a list of groups belonging to this project. + *

Example: `projects/my-project-123/groups/my-group` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ErrorGroup getGroup(ErrorGroupName groupName) { @@ -290,12 +289,11 @@ public final ErrorGroup getGroup(ErrorGroupName groupName) { * } * * - * @param groupName Required. The group resource name. Written as - * <code>projects/<var>projectID</var>/groups/<var>group_name</var></code>. - * Call <a href="/https/patch-diff.githubusercontent.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list"> - * <code>groupStats.list</code></a> to return a list of groups belonging to - * this project. - *

Example: <code>projects/my-project-123/groups/my-group</code> + * @param groupName The group resource name. Written as + * `projects/{projectID}/groups/{group_name}`. Call + * [`groupStats.list`](https://cloud.google.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list) + * to return a list of groups belonging to this project. + *

Example: `projects/my-project-123/groups/my-group` * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ErrorGroup getGroup(String groupName) { diff --git a/proto-google-cloud-error-reporting-v1beta1/src/main/java/com/google/devtools/clouderrorreporting/v1beta1/GetGroupRequest.java b/proto-google-cloud-error-reporting-v1beta1/src/main/java/com/google/devtools/clouderrorreporting/v1beta1/GetGroupRequest.java index 1c9cb312..942d46aa 100644 --- a/proto-google-cloud-error-reporting-v1beta1/src/main/java/com/google/devtools/clouderrorreporting/v1beta1/GetGroupRequest.java +++ b/proto-google-cloud-error-reporting-v1beta1/src/main/java/com/google/devtools/clouderrorreporting/v1beta1/GetGroupRequest.java @@ -117,13 +117,11 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * * * 

-   * Required. The group resource name. Written as
-   * <code>projects/<var>projectID</var>/groups/<var>group_name</var></code>.
-   * Call
-   * <a href="/https/patch-diff.githubusercontent.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list">
-   * <code>groupStats.list</code></a> to return a list of groups belonging to
-   * this project.
-   * Example: <code>projects/my-project-123/groups/my-group</code>
+   * The group resource name. Written as
+   * `projects/{projectID}/groups/{group_name}`. Call
+   * [`groupStats.list`](https://cloud.google.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list)
+   * to return a list of groups belonging to this project.
+   * Example: `projects/my-project-123/groups/my-group`
    *
* * @@ -148,13 +146,11 @@ public java.lang.String getGroupName() { * * * 
-   * Required. The group resource name. Written as
-   * <code>projects/<var>projectID</var>/groups/<var>group_name</var></code>.
-   * Call
-   * <a href="/https/patch-diff.githubusercontent.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list">
-   * <code>groupStats.list</code></a> to return a list of groups belonging to
-   * this project.
-   * Example: <code>projects/my-project-123/groups/my-group</code>
+   * The group resource name. Written as
+   * `projects/{projectID}/groups/{group_name}`. Call
+   * [`groupStats.list`](https://cloud.google.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list)
+   * to return a list of groups belonging to this project.
+   * Example: `projects/my-project-123/groups/my-group`
    *
* * @@ -504,13 +500,11 @@ public Builder mergeFrom( * * * 
-     * Required. The group resource name. Written as
-     * <code>projects/<var>projectID</var>/groups/<var>group_name</var></code>.
-     * Call
-     * <a href="/https/patch-diff.githubusercontent.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list">
-     * <code>groupStats.list</code></a> to return a list of groups belonging to
-     * this project.
-     * Example: <code>projects/my-project-123/groups/my-group</code>
+     * The group resource name. Written as
+     * `projects/{projectID}/groups/{group_name}`. Call
+     * [`groupStats.list`](https://cloud.google.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list)
+     * to return a list of groups belonging to this project.
+     * Example: `projects/my-project-123/groups/my-group`
      *
* * @@ -534,13 +528,11 @@ public java.lang.String getGroupName() { * * * 
-     * Required. The group resource name. Written as
-     * <code>projects/<var>projectID</var>/groups/<var>group_name</var></code>.
-     * Call
-     * <a href="/https/patch-diff.githubusercontent.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list">
-     * <code>groupStats.list</code></a> to return a list of groups belonging to
-     * this project.
-     * Example: <code>projects/my-project-123/groups/my-group</code>
+     * The group resource name. Written as
+     * `projects/{projectID}/groups/{group_name}`. Call
+     * [`groupStats.list`](https://cloud.google.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list)
+     * to return a list of groups belonging to this project.
+     * Example: `projects/my-project-123/groups/my-group`
      *
* * @@ -564,13 +556,11 @@ public com.google.protobuf.ByteString getGroupNameBytes() { * * * 
-     * Required. The group resource name. Written as
-     * <code>projects/<var>projectID</var>/groups/<var>group_name</var></code>.
-     * Call
-     * <a href="/https/patch-diff.githubusercontent.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list">
-     * <code>groupStats.list</code></a> to return a list of groups belonging to
-     * this project.
-     * Example: <code>projects/my-project-123/groups/my-group</code>
+     * The group resource name. Written as
+     * `projects/{projectID}/groups/{group_name}`. Call
+     * [`groupStats.list`](https://cloud.google.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list)
+     * to return a list of groups belonging to this project.
+     * Example: `projects/my-project-123/groups/my-group`
      *
* * @@ -593,13 +583,11 @@ public Builder setGroupName(java.lang.String value) { * * * 
-     * Required. The group resource name. Written as
-     * <code>projects/<var>projectID</var>/groups/<var>group_name</var></code>.
-     * Call
-     * <a href="/https/patch-diff.githubusercontent.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list">
-     * <code>groupStats.list</code></a> to return a list of groups belonging to
-     * this project.
-     * Example: <code>projects/my-project-123/groups/my-group</code>
+     * The group resource name. Written as
+     * `projects/{projectID}/groups/{group_name}`. Call
+     * [`groupStats.list`](https://cloud.google.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list)
+     * to return a list of groups belonging to this project.
+     * Example: `projects/my-project-123/groups/my-group`
      *
* * @@ -618,13 +606,11 @@ public Builder clearGroupName() { * * * 
-     * Required. The group resource name. Written as
-     * <code>projects/<var>projectID</var>/groups/<var>group_name</var></code>.
-     * Call
-     * <a href="/https/patch-diff.githubusercontent.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list">
-     * <code>groupStats.list</code></a> to return a list of groups belonging to
-     * this project.
-     * Example: <code>projects/my-project-123/groups/my-group</code>
+     * The group resource name. Written as
+     * `projects/{projectID}/groups/{group_name}`. Call
+     * [`groupStats.list`](https://cloud.google.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list)
+     * to return a list of groups belonging to this project.
+     * Example: `projects/my-project-123/groups/my-group`
      *
* * diff --git a/proto-google-cloud-error-reporting-v1beta1/src/main/java/com/google/devtools/clouderrorreporting/v1beta1/GetGroupRequestOrBuilder.java b/proto-google-cloud-error-reporting-v1beta1/src/main/java/com/google/devtools/clouderrorreporting/v1beta1/GetGroupRequestOrBuilder.java index ada8f6fa..f8ea5ca5 100644 --- a/proto-google-cloud-error-reporting-v1beta1/src/main/java/com/google/devtools/clouderrorreporting/v1beta1/GetGroupRequestOrBuilder.java +++ b/proto-google-cloud-error-reporting-v1beta1/src/main/java/com/google/devtools/clouderrorreporting/v1beta1/GetGroupRequestOrBuilder.java @@ -27,13 +27,11 @@ public interface GetGroupRequestOrBuilder * * * 
-   * Required. The group resource name. Written as
-   * <code>projects/<var>projectID</var>/groups/<var>group_name</var></code>.
-   * Call
-   * <a href="/https/patch-diff.githubusercontent.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list">
-   * <code>groupStats.list</code></a> to return a list of groups belonging to
-   * this project.
-   * Example: <code>projects/my-project-123/groups/my-group</code>
+   * The group resource name. Written as
+   * `projects/{projectID}/groups/{group_name}`. Call
+   * [`groupStats.list`](https://cloud.google.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list)
+   * to return a list of groups belonging to this project.
+   * Example: `projects/my-project-123/groups/my-group`
    *
* * @@ -47,13 +45,11 @@ public interface GetGroupRequestOrBuilder * * * 
-   * Required. The group resource name. Written as
-   * <code>projects/<var>projectID</var>/groups/<var>group_name</var></code>.
-   * Call
-   * <a href="/https/patch-diff.githubusercontent.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list">
-   * <code>groupStats.list</code></a> to return a list of groups belonging to
-   * this project.
-   * Example: <code>projects/my-project-123/groups/my-group</code>
+   * The group resource name. Written as
+   * `projects/{projectID}/groups/{group_name}`. Call
+   * [`groupStats.list`](https://cloud.google.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list)
+   * to return a list of groups belonging to this project.
+   * Example: `projects/my-project-123/groups/my-group`
    *
* * diff --git a/proto-google-cloud-error-reporting-v1beta1/src/main/java/com/google/devtools/clouderrorreporting/v1beta1/TrackingIssue.java b/proto-google-cloud-error-reporting-v1beta1/src/main/java/com/google/devtools/clouderrorreporting/v1beta1/TrackingIssue.java index 273fb91f..a3e37273 100644 --- a/proto-google-cloud-error-reporting-v1beta1/src/main/java/com/google/devtools/clouderrorreporting/v1beta1/TrackingIssue.java +++ b/proto-google-cloud-error-reporting-v1beta1/src/main/java/com/google/devtools/clouderrorreporting/v1beta1/TrackingIssue.java @@ -118,7 +118,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * * 
    * A URL pointing to a related entry in an issue tracking system.
-   * Example: https://github.com/user/project/issues/4
+   * Example: `https://github.com/user/project/issues/4`
    *
* * string url = 1; @@ -142,7 +142,7 @@ public java.lang.String getUrl() { * * 
    * A URL pointing to a related entry in an issue tracking system.
-   * Example: https://github.com/user/project/issues/4
+   * Example: `https://github.com/user/project/issues/4`
    *
* * string url = 1; @@ -490,7 +490,7 @@ public Builder mergeFrom( * * 
      * A URL pointing to a related entry in an issue tracking system.
-     * Example: https://github.com/user/project/issues/4
+     * Example: `https://github.com/user/project/issues/4`
      *
* * string url = 1; @@ -513,7 +513,7 @@ public java.lang.String getUrl() { * * 
      * A URL pointing to a related entry in an issue tracking system.
-     * Example: https://github.com/user/project/issues/4
+     * Example: `https://github.com/user/project/issues/4`
      *
* * string url = 1; @@ -536,7 +536,7 @@ public com.google.protobuf.ByteString getUrlBytes() { * * 
      * A URL pointing to a related entry in an issue tracking system.
-     * Example: https://github.com/user/project/issues/4
+     * Example: `https://github.com/user/project/issues/4`
      *
* * string url = 1; @@ -558,7 +558,7 @@ public Builder setUrl(java.lang.String value) { * * 
      * A URL pointing to a related entry in an issue tracking system.
-     * Example: https://github.com/user/project/issues/4
+     * Example: `https://github.com/user/project/issues/4`
      *
* * string url = 1; @@ -576,7 +576,7 @@ public Builder clearUrl() { * * 
      * A URL pointing to a related entry in an issue tracking system.
-     * Example: https://github.com/user/project/issues/4
+     * Example: `https://github.com/user/project/issues/4`
      *
* * string url = 1; diff --git a/proto-google-cloud-error-reporting-v1beta1/src/main/java/com/google/devtools/clouderrorreporting/v1beta1/TrackingIssueOrBuilder.java b/proto-google-cloud-error-reporting-v1beta1/src/main/java/com/google/devtools/clouderrorreporting/v1beta1/TrackingIssueOrBuilder.java index aac30a5c..74d9e6e0 100644 --- a/proto-google-cloud-error-reporting-v1beta1/src/main/java/com/google/devtools/clouderrorreporting/v1beta1/TrackingIssueOrBuilder.java +++ b/proto-google-cloud-error-reporting-v1beta1/src/main/java/com/google/devtools/clouderrorreporting/v1beta1/TrackingIssueOrBuilder.java @@ -28,7 +28,7 @@ public interface TrackingIssueOrBuilder * * 
    * A URL pointing to a related entry in an issue tracking system.
-   * Example: https://github.com/user/project/issues/4
+   * Example: `https://github.com/user/project/issues/4`
    *
* * string url = 1; @@ -41,7 +41,7 @@ public interface TrackingIssueOrBuilder * * 
    * A URL pointing to a related entry in an issue tracking system.
-   * Example: https://github.com/user/project/issues/4
+   * Example: `https://github.com/user/project/issues/4`
    *
* * string url = 1; diff --git a/proto-google-cloud-error-reporting-v1beta1/src/main/proto/google/devtools/clouderrorreporting/v1beta1/common.proto b/proto-google-cloud-error-reporting-v1beta1/src/main/proto/google/devtools/clouderrorreporting/v1beta1/common.proto index 5a4f0252..32d757fb 100644 --- a/proto-google-cloud-error-reporting-v1beta1/src/main/proto/google/devtools/clouderrorreporting/v1beta1/common.proto +++ b/proto-google-cloud-error-reporting-v1beta1/src/main/proto/google/devtools/clouderrorreporting/v1beta1/common.proto @@ -50,7 +50,7 @@ message ErrorGroup { // Information related to tracking the progress on resolving the error. message TrackingIssue { // A URL pointing to a related entry in an issue tracking system. - // Example: https://github.com/user/project/issues/4 + // Example: `https://github.com/user/project/issues/4` string url = 1; } diff --git a/proto-google-cloud-error-reporting-v1beta1/src/main/proto/google/devtools/clouderrorreporting/v1beta1/error_group_service.proto b/proto-google-cloud-error-reporting-v1beta1/src/main/proto/google/devtools/clouderrorreporting/v1beta1/error_group_service.proto index ab14ab31..8107e402 100644 --- a/proto-google-cloud-error-reporting-v1beta1/src/main/proto/google/devtools/clouderrorreporting/v1beta1/error_group_service.proto +++ b/proto-google-cloud-error-reporting-v1beta1/src/main/proto/google/devtools/clouderrorreporting/v1beta1/error_group_service.proto @@ -57,14 +57,12 @@ service ErrorGroupService { // A request to return an individual group. message GetGroupRequest { - // Required. The group resource name. Written as - // projects/projectID/groups/group_name. - // Call - // - // groupStats.list to return a list of groups belonging to - // this project. + // The group resource name. Written as + // `projects/{projectID}/groups/{group_name}`. Call + // [`groupStats.list`](https://cloud.google.com/error-reporting/reference/rest/v1beta1/projects.groupStats/list) + // to return a list of groups belonging to this project. // - // Example: projects/my-project-123/groups/my-group + // Example: `projects/my-project-123/groups/my-group` string group_name = 1 [ (google.api.field_behavior) = REQUIRED, (google.api.resource_reference) = { diff --git a/synth.metadata b/synth.metadata index 68ed63f6..c98ec497 100644 --- a/synth.metadata +++ b/synth.metadata @@ -4,15 +4,15 @@ "git": { "name": ".", "remote": "https://github.com/googleapis/java-errorreporting.git", - "sha": "438aad7173bc0012823339ac81f272f9b99ab209" + "sha": "ad3af0e085f8917a19c32f67728837897e387e12" } }, { "git": { "name": "googleapis", "remote": "https://github.com/googleapis/googleapis.git", - "sha": "c4e37010d74071851ff24121f522e802231ac86e", - "internalRef": "313460921" + "sha": "8f41c697c67d357665ce9afac18793c8f80ac73c", + "internalRef": "314787285" } }, {