diff --git a/packages/google-cloud-retail/protos/google/cloud/retail/v2/search_service.proto b/packages/google-cloud-retail/protos/google/cloud/retail/v2/search_service.proto
index 402d91da204..27cd38f9aa1 100644
--- a/packages/google-cloud-retail/protos/google/cloud/retail/v2/search_service.proto
+++ b/packages/google-cloud-retail/protos/google/cloud/retail/v2/search_service.proto
@@ -74,172 +74,35 @@ message SearchRequest {
       // [FacetKey.query][google.cloud.retail.v2.SearchRequest.FacetSpec.FacetKey.query]
       // is not specified:
       //
-      // * textual_field =<br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Product.brands][google.cloud.retail.v2.Product.brands].<br>*
-      //     </font>
-      //     "brands";
-      //     <br>
-      //     <font color='categories'>
-      //     *# The
-      //     [Product.categories][google.cloud.retail.v2.Product.categories].<br>*
-      //     </font>
-      //     "categories";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Audience.genders][google.cloud.retail.v2.Audience.genders].<br>*
-      //     </font>
-      //     | "genders";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Audience.age_groups][google.cloud.retail.v2.Audience.age_groups].<br>*
-      //     </font>
-      //     | "ageGroups";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Product.availability][google.cloud.retail.v2.Product.availability].
-      //     Value is one of<br>*
-      //     *# "IN_STOCK", "OUT_OF_STOCK", PREORDER", "BACKORDER".<br>*
-      //     </font>
-      //     | "availability";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [ColorInfo.color_families][google.cloud.retail.v2.ColorInfo.color_families].<br>*
-      //     </font>
-      //     | "colorFamilies";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [ColorInfo.colors][google.cloud.retail.v2.ColorInfo.colors].<br>*
-      //     </font>
-      //     | "colors";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [Product.sizes][google.cloud.retail.v2.Product.sizes].<br>*
-      //     </font>
-      //     | "sizes";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Product.materials][google.cloud.retail.v2.Product.materials].<br>*
-      //     </font>
-      //     | "materials";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Product.patterns][google.cloud.retail.v2.Product.patterns].<br>*
-      //     </font>
-      //     | "patterns";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Product.conditions][google.cloud.retail.v2.Product.conditions].<br>*
-      //     </font>
-      //     | "conditions";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The textual custom attribute in
-      //     [Product][google.cloud.retail.v2.Product] object. Key can<br>*
-      //     *# be any key in the
-      //     [Product.attributes][google.cloud.retail.v2.Product.attributes]
-      //     map<br>*
-      //     *# if the attribute values are textual.<br>*
-      //     *# map.<br>*
-      //     </font>
-      //     | "attributes.key";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.PICKUP_IN_STORE][].<br>*
-      //     </font>
-      //     | "pickupInStore";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.SHIP_TO_STORE][].<br>*
-      //     </font>
-      //     | "shipToStore";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.SAME_DAY_DELIVERY][].<br>*
-      //     </font>
-      //     | "sameDayDelivery";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.NEXT_DAY_DELIVERY][].<br>*
-      //     </font>
-      //     | "nextDayDelivery";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.CUSTOM_TYPE_1][].<br>*
-      //     </font>
-      //     | "customFulfillment1";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.CUSTOM_TYPE_2][].<br>*
-      //     </font>
-      //     | "customFulfillment2";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.CUSTOM_TYPE_3][].<br>*
-      //     </font>
-      //     | "customFulfillment3";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.CUSTOM_TYPE_4][].<br>*
-      //     </font>
-      //     | "customFulfillment4";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.CUSTOM_TYPE_5][].<br>*
-      //     </font>
-      //     | "customFulfillment5";
+      // Textual facet keys:
+      // * brands
+      // * categories
+      // * genders
+      // * ageGroups
+      // * availability
+      // * colorFamilies
+      // * colors
+      // * sizes
+      // * materials
+      // * patterns
+      // * conditions
+      // * attributes.key
+      // * pickupInStore
+      // * shipToStore
+      // * sameDayDelivery
+      // * nextDayDelivery
+      // * customFulfillment1
+      // * customFulfillment2
+      // * customFulfillment3
+      // * customFulfillment4
+      // * customFulfillment5
       //
-      // * numerical_field =<br>
-      //     <font color='grey'>
-      //     *# The
-      //     [PriceInfo.price][google.cloud.retail.v2.PriceInfo.price].<br>*
-      //     </font>
-      //     "price";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The discount. Computed by (original_price-price)/price <br>*
-      //     </font>
-      //     "discount";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Rating.average_rating][google.cloud.retail.v2.Rating.average_rating].<br>*
-      //     </font>
-      //     "rating";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Rating.rating_count][google.cloud.retail.v2.Rating.rating_count].<br>*
-      //     </font>
-      //     "ratingCount";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The numerical custom attribute in
-      //     [Product][google.cloud.retail.v2.Product] object. Key can<br>*
-      //     *# be any key in the
-      //     [Product.attributes][google.cloud.retail.v2.Product.attributes]
-      //     map<br>*
-      //     *# if the attribute values are numerical.<br>*
-      //     </font>
-      //     | "attributes.key";
+      // Numeric facet keys:
+      // * price
+      // * discount
+      // * rating
+      // * ratingCount
+      // * attributes.key
       string key = 1 [(google.api.field_behavior) = REQUIRED];
 
       // Set only if values should be bucketized into intervals. Must be set
@@ -424,11 +287,12 @@ message SearchRequest {
       // Examples:
       //
       // * To boost products with product ID "product_1" or "product_2", and
-      // color
-      //   "Red" or "Blue":<br>
-      //   *(id: ANY("product_1", "product_2"))<br>*
-      //   *AND<br>*
-      //   *(colorFamilies: ANY("Red", "Blue"))<br>*
+      // color "Red" or "Blue":
+      //   ```
+      //   (id: ANY("product_1", "product_2"))
+      //   AND
+      //   (colorFamilies: ANY("Red", "Blue"))
+      //   ```
       string condition = 1;
 
       // Strength of the condition boost, which should be in [-1, 1]. Negative
diff --git a/packages/google-cloud-retail/protos/google/cloud/retail/v2alpha/search_service.proto b/packages/google-cloud-retail/protos/google/cloud/retail/v2alpha/search_service.proto
index 4344eae4182..df0cd86a14a 100644
--- a/packages/google-cloud-retail/protos/google/cloud/retail/v2alpha/search_service.proto
+++ b/packages/google-cloud-retail/protos/google/cloud/retail/v2alpha/search_service.proto
@@ -75,173 +75,35 @@ message SearchRequest {
       // [FacetKey.query][google.cloud.retail.v2alpha.SearchRequest.FacetSpec.FacetKey.query]
       // is not specified:
       //
-      // * textual_field =<br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Product.brands][google.cloud.retail.v2alpha.Product.brands].<br>*
-      //     </font>
-      //     "brands";
-      //     <br>
-      //     <font color='categories'>
-      //     *# The
-      //     [Product.categories][google.cloud.retail.v2alpha.Product.categories].<br>*
-      //     </font>
-      //     "categories";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Audience.genders][google.cloud.retail.v2alpha.Audience.genders].<br>*
-      //     </font>
-      //     | "genders";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Audience.age_groups][google.cloud.retail.v2alpha.Audience.age_groups].<br>*
-      //     </font>
-      //     | "ageGroups";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Product.availability][google.cloud.retail.v2alpha.Product.availability].
-      //     Value is one of<br>*
-      //     *# "IN_STOCK", "OUT_OF_STOCK", PREORDER", "BACKORDER".<br>*
-      //     </font>
-      //     | "availability";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [ColorInfo.color_families][google.cloud.retail.v2alpha.ColorInfo.color_families].<br>*
-      //     </font>
-      //     | "colorFamilies";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [ColorInfo.colors][google.cloud.retail.v2alpha.ColorInfo.colors].<br>*
-      //     </font>
-      //     | "colors";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Product.sizes][google.cloud.retail.v2alpha.Product.sizes].<br>*
-      //     </font>
-      //     | "sizes";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Product.materials][google.cloud.retail.v2alpha.Product.materials].<br>*
-      //     </font>
-      //     | "materials";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Product.patterns][google.cloud.retail.v2alpha.Product.patterns].<br>*
-      //     </font>
-      //     | "patterns";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Product.conditions][google.cloud.retail.v2alpha.Product.conditions].<br>*
-      //     </font>
-      //     | "conditions";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The textual custom attribute in
-      //     [Product][google.cloud.retail.v2alpha.Product] object. Key can<br>*
-      //     *# be any key in the
-      //     [Product.attributes][google.cloud.retail.v2alpha.Product.attributes]
-      //     map<br>*
-      //     *# if the attribute values are textual.<br>*
-      //     *# map.<br>*
-      //     </font>
-      //     | "attributes.key";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.PICKUP_IN_STORE][].<br>*
-      //     </font>
-      //     | "pickupInStore";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.SHIP_TO_STORE][].<br>*
-      //     </font>
-      //     | "shipToStore";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.SAME_DAY_DELIVERY][].<br>*
-      //     </font>
-      //     | "sameDayDelivery";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.NEXT_DAY_DELIVERY][].<br>*
-      //     </font>
-      //     | "nextDayDelivery";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.CUSTOM_TYPE_1][].<br>*
-      //     </font>
-      //     | "customFulfillment1";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.CUSTOM_TYPE_2][].<br>*
-      //     </font>
-      //     | "customFulfillment2";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.CUSTOM_TYPE_3][].<br>*
-      //     </font>
-      //     | "customFulfillment3";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.CUSTOM_TYPE_4][].<br>*
-      //     </font>
-      //     | "customFulfillment4";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.CUSTOM_TYPE_5][].<br>*
-      //     </font>
-      //     | "customFulfillment5";
+      // Textual facet keys:
+      // * brands
+      // * categories
+      // * genders
+      // * ageGroups
+      // * availability
+      // * colorFamilies
+      // * colors
+      // * sizes
+      // * materials
+      // * patterns
+      // * conditions
+      // * attributes.key
+      // * pickupInStore
+      // * shipToStore
+      // * sameDayDelivery
+      // * nextDayDelivery
+      // * customFulfillment1
+      // * customFulfillment2
+      // * customFulfillment3
+      // * customFulfillment4
+      // * customFulfillment5
       //
-      // * numerical_field =<br>
-      //     <font color='grey'>
-      //     *# The
-      //     [PriceInfo.price][google.cloud.retail.v2alpha.PriceInfo.price].<br>*
-      //     </font>
-      //     "price";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The discount. Computed by (original_price-price)/price <br>*
-      //     </font>
-      //     "discount";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Rating.average_rating][google.cloud.retail.v2alpha.Rating.average_rating].<br>*
-      //     </font>
-      //     "rating";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Rating.rating_count][google.cloud.retail.v2alpha.Rating.rating_count].<br>*
-      //     </font>
-      //     "ratingCount";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The numerical custom attribute in
-      //     [Product][google.cloud.retail.v2alpha.Product] object. Key can<br>*
-      //     *# be any key in the
-      //     [Product.attributes][google.cloud.retail.v2alpha.Product.attributes]
-      //     map<br>*
-      //     *# if the attribute values are numerical.<br>*
-      //     </font>
-      //     | "attributes.key";
+      // Numeric facet keys:
+      // * price
+      // * discount
+      // * rating
+      // * ratingCount
+      // * attributes.key
       string key = 1 [(google.api.field_behavior) = REQUIRED];
 
       // Set only if values should be bucketized into intervals. Must be set
@@ -427,11 +289,12 @@ message SearchRequest {
       // Examples:
       //
       // * To boost products with product ID "product_1" or "product_2", and
-      // color
-      //   "Red" or "Blue":<br>
-      //   *(id: ANY("product_1", "product_2"))<br>*
-      //   *AND<br>*
-      //   *(colorFamilies: ANY("Red", "Blue"))<br>*
+      // color "Red" or "Blue":
+      //   ```
+      //   (id: ANY("product_1", "product_2"))
+      //   AND
+      //   (colorFamilies: ANY("Red", "Blue"))
+      //   ```
       string condition = 1;
 
       // Strength of the condition boost, which should be in [-1, 1]. Negative
diff --git a/packages/google-cloud-retail/protos/google/cloud/retail/v2beta/search_service.proto b/packages/google-cloud-retail/protos/google/cloud/retail/v2beta/search_service.proto
index 43cb86207fd..2647c7e0b66 100644
--- a/packages/google-cloud-retail/protos/google/cloud/retail/v2beta/search_service.proto
+++ b/packages/google-cloud-retail/protos/google/cloud/retail/v2beta/search_service.proto
@@ -75,173 +75,35 @@ message SearchRequest {
       // [FacetKey.query][google.cloud.retail.v2beta.SearchRequest.FacetSpec.FacetKey.query]
       // is not specified:
       //
-      // * textual_field =<br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Product.brands][google.cloud.retail.v2beta.Product.brands].<br>*
-      //     </font>
-      //     "brands";
-      //     <br>
-      //     <font color='categories'>
-      //     *# The
-      //     [Product.categories][google.cloud.retail.v2beta.Product.categories].<br>*
-      //     </font>
-      //     "categories";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Audience.genders][google.cloud.retail.v2beta.Audience.genders].<br>*
-      //     </font>
-      //     | "genders";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Audience.age_groups][google.cloud.retail.v2beta.Audience.age_groups].<br>*
-      //     </font>
-      //     | "ageGroups";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Product.availability][google.cloud.retail.v2beta.Product.availability].
-      //     Value is one of<br>*
-      //     *# "IN_STOCK", "OUT_OF_STOCK", PREORDER", "BACKORDER".<br>*
-      //     </font>
-      //     | "availability";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [ColorInfo.color_families][google.cloud.retail.v2beta.ColorInfo.color_families].<br>*
-      //     </font>
-      //     | "colorFamilies";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [ColorInfo.colors][google.cloud.retail.v2beta.ColorInfo.colors].<br>*
-      //     </font>
-      //     | "colors";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Product.sizes][google.cloud.retail.v2beta.Product.sizes].<br>*
-      //     </font>
-      //     | "sizes";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Product.materials][google.cloud.retail.v2beta.Product.materials].<br>*
-      //     </font>
-      //     | "materials";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Product.patterns][google.cloud.retail.v2beta.Product.patterns].<br>*
-      //     </font>
-      //     | "patterns";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Product.conditions][google.cloud.retail.v2beta.Product.conditions].<br>*
-      //     </font>
-      //     | "conditions";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The textual custom attribute in
-      //     [Product][google.cloud.retail.v2beta.Product] object. Key can<br>*
-      //     *# be any key in the
-      //     [Product.attributes][google.cloud.retail.v2beta.Product.attributes]
-      //     map<br>*
-      //     *# if the attribute values are textual.<br>*
-      //     *# map.<br>*
-      //     </font>
-      //     | "attributes.key";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.PICKUP_IN_STORE][].<br>*
-      //     </font>
-      //     | "pickupInStore";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.SHIP_TO_STORE][].<br>*
-      //     </font>
-      //     | "shipToStore";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.SAME_DAY_DELIVERY][].<br>*
-      //     </font>
-      //     | "sameDayDelivery";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.NEXT_DAY_DELIVERY][].<br>*
-      //     </font>
-      //     | "nextDayDelivery";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.CUSTOM_TYPE_1][].<br>*
-      //     </font>
-      //     | "customFulfillment1";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.CUSTOM_TYPE_2][].<br>*
-      //     </font>
-      //     | "customFulfillment2";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.CUSTOM_TYPE_3][].<br>*
-      //     </font>
-      //     | "customFulfillment3";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.CUSTOM_TYPE_4][].<br>*
-      //     </font>
-      //     | "customFulfillment4";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The [FulfillmentInfo.ids][] for type
-      //     *# [FulfillmentInfo.Type.CUSTOM_TYPE_5][].<br>*
-      //     </font>
-      //     | "customFulfillment5";
+      // Textual facet keys:
+      // * brands
+      // * categories
+      // * genders
+      // * ageGroups
+      // * availability
+      // * colorFamilies
+      // * colors
+      // * sizes
+      // * materials
+      // * patterns
+      // * conditions
+      // * attributes.key
+      // * pickupInStore
+      // * shipToStore
+      // * sameDayDelivery
+      // * nextDayDelivery
+      // * customFulfillment1
+      // * customFulfillment2
+      // * customFulfillment3
+      // * customFulfillment4
+      // * customFulfillment5
       //
-      // * numerical_field =<br>
-      //     <font color='grey'>
-      //     *# The
-      //     [PriceInfo.price][google.cloud.retail.v2beta.PriceInfo.price].<br>*
-      //     </font>
-      //     "price";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The discount. Computed by (original_price-price)/price <br>*
-      //     </font>
-      //     "discount";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Rating.average_rating][google.cloud.retail.v2beta.Rating.average_rating].<br>*
-      //     </font>
-      //     "rating";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The
-      //     [Rating.rating_count][google.cloud.retail.v2beta.Rating.rating_count].<br>*
-      //     </font>
-      //     "ratingCount";
-      //     <br>
-      //     <font color='grey'>
-      //     *# The numerical custom attribute in
-      //     [Product][google.cloud.retail.v2beta.Product] object. Key can<br>*
-      //     *# be any key in the
-      //     [Product.attributes][google.cloud.retail.v2beta.Product.attributes]
-      //     map<br>*
-      //     *# if the attribute values are numerical.<br>*
-      //     </font>
-      //     | "attributes.key";
+      // Numeric facet keys:
+      // * price
+      // * discount
+      // * rating
+      // * ratingCount
+      // * attributes.key
       string key = 1 [(google.api.field_behavior) = REQUIRED];
 
       // Set only if values should be bucketized into intervals. Must be set
@@ -427,11 +289,12 @@ message SearchRequest {
       // Examples:
       //
       // * To boost products with product ID "product_1" or "product_2", and
-      // color
-      //   "Red" or "Blue":<br>
-      //   *(id: ANY("product_1", "product_2"))<br>*
-      //   *AND<br>*
-      //   *(colorFamilies: ANY("Red", "Blue"))<br>*
+      // color "Red" or "Blue":
+      //   ```
+      //   (id: ANY("product_1", "product_2"))
+      //   AND
+      //   (colorFamilies: ANY("Red", "Blue"))
+      //   ```
       string condition = 1;
 
       // Strength of the condition boost, which should be in [-1, 1]. Negative