docs: fix several broken links in the docs. (#157)

This PR was generated using Autosynth. 🌈 Synth log will be available here: https://source.cloud.google.com/results/invocations/5a6d8b4a-5d51-4aa7-bbe3-089dd415efba/targets - [ ] To automatically regenerate this PR, check this box. PiperOrigin-RevId: 314787285 Source-Link: googleapis/googleapis@8f41c69
googleapis · Jun 5, 2020 · 9606c51 · 9606c51
1 parent 3a9fff4
commit 9606c51
Show file tree

Hide file tree

Showing 8 changed files with 72 additions and 94 deletions.
diff --git a/...orting/src/main/java/com/google/cloud/errorreporting/v1beta1/ErrorGroupServiceClient.java b/...orting/src/main/java/com/google/cloud/errorreporting/v1beta1/ErrorGroupServiceClient.java
@@ -261,12 +261,11 @@ public final UnaryCallable<UpdateGroupRequest, ErrorGroup> updateGroupCallable()
    * }
    * </code></pre>
    *
-   * @param groupName Required. The group resource name. Written as
-   *     &lt;code&gt;projects/&lt;var&gt;projectID&lt;/var&gt;/groups/&lt;var&gt;group_name&lt;/var&gt;&lt;/code&gt;.
-   *     Call &lt;a href="/error-reporting/reference/rest/v1beta1/projects.groupStats/list"&gt;
-   *     &lt;code&gt;groupStats.list&lt;/code&gt;&lt;/a&gt; to return a list of groups belonging to
-   *     this project.
-   *     <p>Example: &lt;code&gt;projects/my-project-123/groups/my-group&lt;/code&gt;
+   * @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.
+   *     <p>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) {
    * }
    * </code></pre>
    *
-   * @param groupName Required. The group resource name. Written as
-   *     &lt;code&gt;projects/&lt;var&gt;projectID&lt;/var&gt;/groups/&lt;var&gt;group_name&lt;/var&gt;&lt;/code&gt;.
-   *     Call &lt;a href="/error-reporting/reference/rest/v1beta1/projects.groupStats/list"&gt;
-   *     &lt;code&gt;groupStats.list&lt;/code&gt;&lt;/a&gt; to return a list of groups belonging to
-   *     this project.
-   *     <p>Example: &lt;code&gt;projects/my-project-123/groups/my-group&lt;/code&gt;
+   * @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.
+   *     <p>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/...1beta1/src/main/java/com/google/devtools/clouderrorreporting/v1beta1/GetGroupRequest.java b/...1beta1/src/main/java/com/google/devtools/clouderrorreporting/v1beta1/GetGroupRequest.java
@@ -117,13 +117,11 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    *
    * <pre>
-   * Required. The group resource name. Written as
-   * &lt;code&gt;projects/&lt;var&gt;projectID&lt;/var&gt;/groups/&lt;var&gt;group_name&lt;/var&gt;&lt;/code&gt;.
-   * Call
-   * &lt;a href="/error-reporting/reference/rest/v1beta1/projects.groupStats/list"&gt;
-   * &lt;code&gt;groupStats.list&lt;/code&gt;&lt;/a&gt; to return a list of groups belonging to
-   * this project.
-   * Example: &lt;code&gt;projects/my-project-123/groups/my-group&lt;/code&gt;
+   * 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`
    * </pre>
    *
    * <code>
@@ -148,13 +146,11 @@ public java.lang.String getGroupName() {
    *
    *
    * <pre>
-   * Required. The group resource name. Written as
-   * &lt;code&gt;projects/&lt;var&gt;projectID&lt;/var&gt;/groups/&lt;var&gt;group_name&lt;/var&gt;&lt;/code&gt;.
-   * Call
-   * &lt;a href="/error-reporting/reference/rest/v1beta1/projects.groupStats/list"&gt;
-   * &lt;code&gt;groupStats.list&lt;/code&gt;&lt;/a&gt; to return a list of groups belonging to
-   * this project.
-   * Example: &lt;code&gt;projects/my-project-123/groups/my-group&lt;/code&gt;
+   * 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`
    * </pre>
    *
    * <code>
@@ -504,13 +500,11 @@ public Builder mergeFrom(
      *
      *
      * <pre>
-     * Required. The group resource name. Written as
-     * &lt;code&gt;projects/&lt;var&gt;projectID&lt;/var&gt;/groups/&lt;var&gt;group_name&lt;/var&gt;&lt;/code&gt;.
-     * Call
-     * &lt;a href="/error-reporting/reference/rest/v1beta1/projects.groupStats/list"&gt;
-     * &lt;code&gt;groupStats.list&lt;/code&gt;&lt;/a&gt; to return a list of groups belonging to
-     * this project.
-     * Example: &lt;code&gt;projects/my-project-123/groups/my-group&lt;/code&gt;
+     * 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`
      * </pre>
      *
      * <code>
@@ -534,13 +528,11 @@ public java.lang.String getGroupName() {
      *
      *
      * <pre>
-     * Required. The group resource name. Written as
-     * &lt;code&gt;projects/&lt;var&gt;projectID&lt;/var&gt;/groups/&lt;var&gt;group_name&lt;/var&gt;&lt;/code&gt;.
-     * Call
-     * &lt;a href="/error-reporting/reference/rest/v1beta1/projects.groupStats/list"&gt;
-     * &lt;code&gt;groupStats.list&lt;/code&gt;&lt;/a&gt; to return a list of groups belonging to
-     * this project.
-     * Example: &lt;code&gt;projects/my-project-123/groups/my-group&lt;/code&gt;
+     * 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`
      * </pre>
      *
      * <code>
@@ -564,13 +556,11 @@ public com.google.protobuf.ByteString getGroupNameBytes() {
      *
      *
      * <pre>
-     * Required. The group resource name. Written as
-     * &lt;code&gt;projects/&lt;var&gt;projectID&lt;/var&gt;/groups/&lt;var&gt;group_name&lt;/var&gt;&lt;/code&gt;.
-     * Call
-     * &lt;a href="/error-reporting/reference/rest/v1beta1/projects.groupStats/list"&gt;
-     * &lt;code&gt;groupStats.list&lt;/code&gt;&lt;/a&gt; to return a list of groups belonging to
-     * this project.
-     * Example: &lt;code&gt;projects/my-project-123/groups/my-group&lt;/code&gt;
+     * 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`
      * </pre>
      *
      * <code>
@@ -593,13 +583,11 @@ public Builder setGroupName(java.lang.String value) {
      *
      *
      * <pre>
-     * Required. The group resource name. Written as
-     * &lt;code&gt;projects/&lt;var&gt;projectID&lt;/var&gt;/groups/&lt;var&gt;group_name&lt;/var&gt;&lt;/code&gt;.
-     * Call
-     * &lt;a href="/error-reporting/reference/rest/v1beta1/projects.groupStats/list"&gt;
-     * &lt;code&gt;groupStats.list&lt;/code&gt;&lt;/a&gt; to return a list of groups belonging to
-     * this project.
-     * Example: &lt;code&gt;projects/my-project-123/groups/my-group&lt;/code&gt;
+     * 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`
      * </pre>
      *
      * <code>
@@ -618,13 +606,11 @@ public Builder clearGroupName() {
      *
      *
      * <pre>
-     * Required. The group resource name. Written as
-     * &lt;code&gt;projects/&lt;var&gt;projectID&lt;/var&gt;/groups/&lt;var&gt;group_name&lt;/var&gt;&lt;/code&gt;.
-     * Call
-     * &lt;a href="/error-reporting/reference/rest/v1beta1/projects.groupStats/list"&gt;
-     * &lt;code&gt;groupStats.list&lt;/code&gt;&lt;/a&gt; to return a list of groups belonging to
-     * this project.
-     * Example: &lt;code&gt;projects/my-project-123/groups/my-group&lt;/code&gt;
+     * 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`
      * </pre>
      *
      * <code>

diff --git a/...c/main/java/com/google/devtools/clouderrorreporting/v1beta1/GetGroupRequestOrBuilder.java b/...c/main/java/com/google/devtools/clouderrorreporting/v1beta1/GetGroupRequestOrBuilder.java
@@ -27,13 +27,11 @@ public interface GetGroupRequestOrBuilder
    *
    *
    * <pre>
-   * Required. The group resource name. Written as
-   * &lt;code&gt;projects/&lt;var&gt;projectID&lt;/var&gt;/groups/&lt;var&gt;group_name&lt;/var&gt;&lt;/code&gt;.
-   * Call
-   * &lt;a href="/error-reporting/reference/rest/v1beta1/projects.groupStats/list"&gt;
-   * &lt;code&gt;groupStats.list&lt;/code&gt;&lt;/a&gt; to return a list of groups belonging to
-   * this project.
-   * Example: &lt;code&gt;projects/my-project-123/groups/my-group&lt;/code&gt;
+   * 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`
    * </pre>
    *
    * <code>
@@ -47,13 +45,11 @@ public interface GetGroupRequestOrBuilder
    *
    *
    * <pre>
-   * Required. The group resource name. Written as
-   * &lt;code&gt;projects/&lt;var&gt;projectID&lt;/var&gt;/groups/&lt;var&gt;group_name&lt;/var&gt;&lt;/code&gt;.
-   * Call
-   * &lt;a href="/error-reporting/reference/rest/v1beta1/projects.groupStats/list"&gt;
-   * &lt;code&gt;groupStats.list&lt;/code&gt;&lt;/a&gt; to return a list of groups belonging to
-   * this project.
-   * Example: &lt;code&gt;projects/my-project-123/groups/my-group&lt;/code&gt;
+   * 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`
    * </pre>
    *
    * <code>

diff --git a/...-v1beta1/src/main/java/com/google/devtools/clouderrorreporting/v1beta1/TrackingIssue.java b/...-v1beta1/src/main/java/com/google/devtools/clouderrorreporting/v1beta1/TrackingIssue.java
@@ -118,7 +118,7 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
    *
    * <pre>
    * 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`
    * </pre>
    *
    * <code>string url = 1;</code>
@@ -142,7 +142,7 @@ public java.lang.String getUrl() {
    *
    * <pre>
    * 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`
    * </pre>
    *
    * <code>string url = 1;</code>
@@ -490,7 +490,7 @@ public Builder mergeFrom(
      *
      * <pre>
      * 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`
      * </pre>
      *
      * <code>string url = 1;</code>
@@ -513,7 +513,7 @@ public java.lang.String getUrl() {
      *
      * <pre>
      * 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`
      * </pre>
      *
      * <code>string url = 1;</code>
@@ -536,7 +536,7 @@ public com.google.protobuf.ByteString getUrlBytes() {
      *
      * <pre>
      * 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`
      * </pre>
      *
      * <code>string url = 1;</code>
@@ -558,7 +558,7 @@ public Builder setUrl(java.lang.String value) {
      *
      * <pre>
      * 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`
      * </pre>
      *
      * <code>string url = 1;</code>
@@ -576,7 +576,7 @@ public Builder clearUrl() {
      *
      * <pre>
      * 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`
      * </pre>
      *
      * <code>string url = 1;</code>

diff --git a/...src/main/java/com/google/devtools/clouderrorreporting/v1beta1/TrackingIssueOrBuilder.java b/...src/main/java/com/google/devtools/clouderrorreporting/v1beta1/TrackingIssueOrBuilder.java
@@ -28,7 +28,7 @@ public interface TrackingIssueOrBuilder
    *
    * <pre>
    * 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`
    * </pre>
    *
    * <code>string url = 1;</code>
@@ -41,7 +41,7 @@ public interface TrackingIssueOrBuilder
    *
    * <pre>
    * 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`
    * </pre>
    *
    * <code>string url = 1;</code>

diff --git a/...reporting-v1beta1/src/main/proto/google/devtools/clouderrorreporting/v1beta1/common.proto b/...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/...eta1/src/main/proto/google/devtools/clouderrorreporting/v1beta1/error_group_service.proto b/...eta1/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
-  // <code>projects/<var>projectID</var>/groups/<var>group_name</var></code>.
-  // Call
-  // <a href="/error-reporting/reference/rest/v1beta1/projects.groupStats/list">
-  // <code>groupStats.list</code></a> 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: <code>projects/my-project-123/groups/my-group</code>
+  // 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
@@ -11,8 +11,8 @@
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "c4e37010d74071851ff24121f522e802231ac86e",
-        "internalRef": "313460921"
+        "sha": "8f41c697c67d357665ce9afac18793c8f80ac73c",
+        "internalRef": "314787285"
       }
     },
     {