docs: Properly format literal strings.

Google APIs · copybara-github · commit f563b1dffee4 · 2020-05-26T09:13:06.000-07:00
PiperOrigin-RevId: 313202929
diff --git a/google/cloud/asset/v1/assets.proto b/google/cloud/asset/v1/assets.proto
@@ -48,7 +48,7 @@ message TemporalAsset {
   Asset asset = 3;
 }
 
-// A time window specified by its "start_time" and "end_time".
+// A time window specified by its `start_time` and `end_time`.
 message TimeWindow {
   // Start time of the time window (exclusive).
   google.protobuf.Timestamp start_time = 1;
@@ -70,14 +70,14 @@ message Asset {
   };
 
   // The full name of the asset. For example:
-  // "//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1"
+  // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`
   //
   // See [Resource
   // names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
   // for more information.
   string name = 1;
 
-  // The type of the asset. For example: "compute.googleapis.com/Disk"
+  // The type of the asset. For example: `compute.googleapis.com/Disk`
   //
   // See [Supported asset
   // types](https://cloud.google.com/asset-inventory/docs/supported-asset-types)
@@ -128,27 +128,27 @@ message Asset {
 
 // A representation of a Google Cloud resource.
 message Resource {
-  // The API version. For example: "v1"
+  // The API version. For example: `v1`
   string version = 1;
 
   // The URL of the discovery document containing the resource's JSON schema.
   // For example:
-  // "https://www.googleapis.com/discovery/v1/apis/compute/v1/rest"
+  // `https://www.googleapis.com/discovery/v1/apis/compute/v1/rest`
   //
   // This value is unspecified for resources that do not have an API based on a
   // discovery document, such as Cloud Bigtable.
   string discovery_document_uri = 2;
 
   // The JSON schema name listed in the discovery document. For example:
-  // "Project"
+  // `Project`
   //
   // This value is unspecified for resources that do not have an API based on a
   // discovery document, such as Cloud Bigtable.
   string discovery_name = 3;
 
   // The REST URL for accessing the resource. An HTTP `GET` request using this
   // URL returns the resource itself. For example:
-  // "https://cloudresourcemanager.googleapis.com/v1/projects/my-project-123"
+  // `https://cloudresourcemanager.googleapis.com/v1/projects/my-project-123`
   //
   // This value is unspecified for resources without a REST API.
   string resource_url = 4;
@@ -162,7 +162,7 @@ message Resource {
   // [Cloud IAM policy
   // hierarchy](https://cloud.google.com/iam/docs/overview#policy_hierarchy).
   // For example:
-  // "//cloudresourcemanager.googleapis.com/projects/my_project_123"
+  // `//cloudresourcemanager.googleapis.com/projects/my_project_123`
   //
   // For third-party assets, this field may be set differently.
   string parent = 5;
@@ -179,7 +179,7 @@ message Resource {
 // A result of Resource Search, containing information of a cloud resoure.
 message ResourceSearchResult {
   // The full resource name of this resource. Example:
-  // "//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1".
+  // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
   // See [Cloud Asset Inventory Resource Name
   // Format](https://cloud.google.com/asset-inventory/docs/resource-name-format)
   // for more information.
@@ -190,7 +190,7 @@ message ResourceSearchResult {
   // * use a free text query. Example: `"instance1"`
   string name = 1;
 
-  // The type of this resource. Example: "compute.googleapis.com/Disk".
+  // The type of this resource. Example: `compute.googleapis.com/Disk`.
   //
   // To search against the `asset_type`:
   //
@@ -222,8 +222,8 @@ message ResourceSearchResult {
   // * use a free text query. Example: `"*important instance*"`
   string description = 5;
 
-  // Location can be "global", regional like "us-east1", or zonal like
-  // "us-west1-b".
+  // Location can be `global`, regional like `us-east1`, or zonal like
+  // `us-west1-b`.
   //
   // To search against the `location`:
   //
@@ -256,13 +256,13 @@ message ResourceSearchResult {
   repeated string network_tags = 8;
 
   // The additional attributes of this resource. The attributes may vary from
-  // one resource type to another. Examples: "projectId" for Project,
-  // "dnsName" for DNS ManagedZone.
+  // one resource type to another. Examples: `projectId` for Project,
+  // `dnsName` for DNS ManagedZone.
   //
   // To search against the `additional_attributes`:
   //
   // * use a free text query to match the attributes values. Example: to search
-  //   additional_attributes = { dnsName: "foobar" }, you can issue a query
+  //   `additional_attributes = { dnsName: "foobar" }`, you can issue a query
   //   `"foobar"`.
   google.protobuf.Struct additional_attributes = 9;
 }
@@ -273,23 +273,23 @@ message IamPolicySearchResult {
   message Explanation {
     // IAM permissions
     message Permissions {
-      // A list of permissions. A sample permission string: "compute.disk.get".
+      // A list of permissions. A sample permission string: `compute.disk.get`.
       repeated string permissions = 1;
     }
 
     // The map from roles to their included permissions that match the
     // permission query (i.e., a query containing `policy.role.permissions:`).
     // Example: if query `policy.role.permissions : "compute.disk.get"`
     // matches a policy binding that contains owner role, the
-    // matched_permissions will be {"roles/owner": ["compute.disk.get"]}. The
+    // matched_permissions will be `{"roles/owner": ["compute.disk.get"]}`. The
     // roles can also be found in the returned `policy` bindings. Note that the
     // map is populated only for requests with permission queries.
     map<string, Permissions> matched_permissions = 1;
   }
 
   // The full resource name of the resource associated with this IAM policy.
   // Example:
-  // "//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1".
+  // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
   // See [Cloud Asset Inventory Resource Name
   // Format](https://cloud.google.com/asset-inventory/docs/resource-name-format)
   // for more information.
