docs: Improved formatting

Google APIs · copybara-github · commit c7b3bd0aa138 · 2021-11-09T03:47:33.000-08:00
PiperOrigin-RevId: 408569512
diff --git a/google/cloud/datacatalog/v1/datacatalog.proto b/google/cloud/datacatalog/v1/datacatalog.proto
@@ -359,9 +359,9 @@ service DataCatalog {
   // Creates a tag and assigns it to:
   //
   // * An [Entry][google.cloud.datacatalog.v1.Entry] if the method name is
-  //   ``projects.locations.entryGroups.entries.tags.create``.
+  //   `projects.locations.entryGroups.entries.tags.create`.
   // * Or [EntryGroup][google.cloud.datacatalog.v1.EntryGroup]if the method
-  //   name is ``projects.locations.entryGroups.tags.create``.
+  //   name is `projects.locations.entryGroups.tags.create`.
   //
   // Note: The project identified by the `parent` parameter for the [tag]
   // (https://cloud.google.com/data-catalog/docs/reference/rest/v1/projects.locations.entryGroups.entries.tags/create#path-parameters)
@@ -555,7 +555,7 @@ message SearchCatalogRequest {
     // explicit permissions on them to view them. For example, if you are the
     // owner.
     //
-    // Other scope fields, for example, ``include_org_ids``,
+    // Other scope fields, for example, `include_org_ids`,
     // still restrict the returned public tag templates and at least one of
     // them is required.
     bool include_public_tag_templates = 19 [(google.api.field_behavior) = OPTIONAL];
@@ -570,7 +570,8 @@ message SearchCatalogRequest {
 
   // Optional. The query string with a minimum of 3 characters and specific syntax.
   // For more information, see
-  // [Data Catalog search syntax](/data-catalog/docs/how-to/search-reference).
+  // [Data Catalog search
+  // syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference).
   //
   // An empty query string returns all data assets (in the specified scope)
   // that you have access to.
@@ -921,6 +922,7 @@ message Entry {
   // and read-only afterwards. Can be used for search and lookup of the entries.
   //
   //
+  //
   // FQNs take two forms:
   //
   // * For non-regionalized resources:
@@ -1234,9 +1236,9 @@ message UpdateTagTemplateRequest {
   // are overwritten. If such fields are non-required and omitted in the
   // request body, their values are emptied.
   //
-  // Note: Updating the ``is_publicly_readable`` field may require up to 12
+  // Note: Updating the `is_publicly_readable` field may require up to 12
   // hours to take effect in search results. Additionally, it also requires
-  // the ``tagTemplates.getIamPolicy`` and ``tagTemplates.setIamPolicy``
+  // the `tagTemplates.getIamPolicy` and `tagTemplates.setIamPolicy`
   // permissions.
   google.protobuf.FieldMask update_mask = 2;
 }
