fix(specs): adjust style for banner descriptions (generated)

algolia/api-clients-automation#4362

Co-authored-by: algolia-bot <accounts+algolia-api-client-bot@algolia.com>
Co-authored-by: Kai Welke <kai.welke@algolia.com>
Co-authored-by: Pierre Millot <pierre.millot@algolia.com>

client/src/commonMain/kotlin/com/algolia/client/model/recommend/Banner.kt

@@ -5,7 +5,7 @@ import kotlinx.serialization.*
 import kotlinx.serialization.json.*
 
 /**
- * a search banner with image and url.
+ * Banner with image and link to redirect users.
  *
  * @param image
  * @param link

client/src/commonMain/kotlin/com/algolia/client/model/recommend/BannerImage.kt

@@ -5,7 +5,7 @@ import kotlinx.serialization.*
 import kotlinx.serialization.json.*
 
 /**
- * image of a search banner.
+ * Image to show inside a banner.
  *
  * @param urls
  * @param title

client/src/commonMain/kotlin/com/algolia/client/model/recommend/BannerImageUrl.kt

@@ -5,7 +5,7 @@ import kotlinx.serialization.*
 import kotlinx.serialization.json.*
 
 /**
- * url for a search banner image.
+ * URL for an image to show inside a banner.
  *
  * @param url
  */

client/src/commonMain/kotlin/com/algolia/client/model/recommend/BannerLink.kt

@@ -5,7 +5,7 @@ import kotlinx.serialization.*
 import kotlinx.serialization.json.*
 
 /**
- * link for a banner defined in merchandising studio.
+ * Link for a banner defined in the Merchandising Studio.
  *
  * @param url
  */

client/src/commonMain/kotlin/com/algolia/client/model/recommend/Widgets.kt

@@ -5,13 +5,13 @@ import kotlinx.serialization.*
 import kotlinx.serialization.json.*
 
 /**
- * widgets returned from any rules that are applied to the current search.
+ * Widgets returned from any rules that are applied to the current search.
  *
- * @param banners banners defined in the merchandising studio for the given search.
+ * @param banners Banners defined in the Merchandising Studio for a given search.
  */
 @Serializable
 public data class Widgets(
 
-  /** banners defined in the merchandising studio for the given search. */
+  /** Banners defined in the Merchandising Studio for a given search. */
   @SerialName(value = "banners") val banners: List<Banner>? = null,
 )

client/src/commonMain/kotlin/com/algolia/client/model/search/Banner.kt

@@ -5,7 +5,7 @@ import kotlinx.serialization.*
 import kotlinx.serialization.json.*
 
 /**
- * a search banner with image and url.
+ * Banner with image and link to redirect users.
  *
  * @param image
  * @param link

client/src/commonMain/kotlin/com/algolia/client/model/search/BannerImage.kt

@@ -5,7 +5,7 @@ import kotlinx.serialization.*
 import kotlinx.serialization.json.*
 
 /**
- * image of a search banner.
+ * Image to show inside a banner.
  *
  * @param urls
  * @param title

client/src/commonMain/kotlin/com/algolia/client/model/search/BannerImageUrl.kt

@@ -5,7 +5,7 @@ import kotlinx.serialization.*
 import kotlinx.serialization.json.*
 
 /**
- * url for a search banner image.
+ * URL for an image to show inside a banner.
  *
  * @param url
  */

client/src/commonMain/kotlin/com/algolia/client/model/search/BannerLink.kt

@@ -5,7 +5,7 @@ import kotlinx.serialization.*
 import kotlinx.serialization.json.*
 
 /**
- * link for a banner defined in merchandising studio.
+ * Link for a banner defined in the Merchandising Studio.
  *
  * @param url
  */

client/src/commonMain/kotlin/com/algolia/client/model/search/Widgets.kt

@@ -5,13 +5,13 @@ import kotlinx.serialization.*
 import kotlinx.serialization.json.*
 
 /**
- * widgets returned from any rules that are applied to the current search.
+ * Widgets returned from any rules that are applied to the current search.
  *
- * @param banners banners defined in the merchandising studio for the given search.
+ * @param banners Banners defined in the Merchandising Studio for a given search.
  */
 @Serializable
 public data class Widgets(
 
-  /** banners defined in the merchandising studio for the given search. */
+  /** Banners defined in the Merchandising Studio for a given search. */
   @SerialName(value = "banners") val banners: List<Banner>? = null,
 )